Go言語のhttp.ServeMuxを使ったルーティングの基本

先生と生徒の会話形式で理解しよう

生徒

「先生、Go言語でWebアプリを作るときに、URLごとに処理を分けたいんですけど、どうすればいいですか？」

先生

「それなら、Go標準ライブラリのhttp.ServeMuxを使うと便利です。URLごとに処理を登録できるんですよ。」

生徒

「ServeMuxって何ですか？」

先生

「ServeMuxは、URLとハンドラー（処理）を結びつけるルーターのようなものです。アクセスされたURLに応じて、どの処理を呼び出すか判断してくれます。」

生徒

「なるほど、具体的な例を見せてもらえますか？」

1. http.ServeMuxでルーティングする基本

Go言語では、http.NewServeMux()でServeMuxのインスタンスを作り、HandleFuncメソッドでURLごとの処理を登録します。最後にhttp.ListenAndServeでサーバーを起動します。 ServeMuxは「どのURLにアクセスされたら、どの処理を動かすか」をまとめて管理する役割があり、Webアプリの入り口を整理するのに向いています。

初心者の方は、まず「URLパス」と「ハンドラー関数」がセットになっている点を押さえると理解が早いです。たとえば/helloというURLに対してhelloHandlerを登録しておけば、ブラウザでそのURLを開いたときに、登録した処理が呼び出されます。こうしてページごとに処理を分けられるのが、ルーティングの基本です。


package main

import (
    "fmt"
    "net/http"
)

func helloHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "こんにちは、Goの世界へようこそ！")
}

func aboutHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "このページはGo言語で作られたサンプルです。")
}

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/hello", helloHandler)
    mux.HandleFunc("/about", aboutHandler)

    http.ListenAndServe(":8080", mux)
}

この例では、/helloにアクセスするとhelloHandlerが呼ばれ、/aboutにアクセスするとaboutHandlerが呼ばれます。ServeMuxがURLごとに適切な処理を振り分けてくれる仕組みです。実際に動かすときは、サーバー起動後にブラウザでhttp://localhost:8080/helloのようにアクセスすると、ページが切り替わる感覚で確認できます。

2. ServeMuxを使うメリット

ServeMuxを使うことで、URLごとの処理を簡単に整理でき、複雑なWebアプリでもスッキリした構造にできます。とくに「ページが増えてきたときに迷子になりにくい」のが大きな利点です。どのURLがどの処理につながっているかが見えやすくなるので、あとから機能を追加したり、修正したりするときも安心です。

URLパスごとにハンドラーを登録できるので、処理が分かりやすい。
標準ライブラリだけでルーティングが可能で、外部ライブラリを使わなくてもOK。
ServeMuxを変数にしておけば、複数のルーターを使い分けることもできる。
ハンドラー関数はhttp.ResponseWriterと*http.Requestを受け取る形式で統一されているので、処理の共通化が簡単。

例えば「まずはトップページだけ」「次にお問い合わせページも追加」といった形で少しずつWebアプリを育てる場合でも、 ServeMuxならURLと処理を一か所で管理しやすく、初心者の方でも全体像をつかみやすくなります。結果として、Go言語でのWebアプリ開発でURLごとのルーティングを整理しやすくなります。


func main() {
    mux := http.NewServeMux()

    // 追加したいページが増えても、このように並べて管理できます
    mux.HandleFunc("/hello", helloHandler)
    mux.HandleFunc("/about", aboutHandler)

    http.ListenAndServe(":8080", mux)
}

このように、ルーティングの登録をまとめておくと「どこに何があるか」が分かりやすくなります。最初はページが少なくても、早い段階からServeMuxに慣れておくと、後で拡張するときに困りにくいです。

3. URLルーティングの応用例

ServeMuxを使うと、ユーザー向けページや管理用ページなど、役割の異なるURLを分かりやすく整理できます。これは、実際のWebアプリ開発でとてもよく使われる構成です。ページの目的ごとにURLを分けておくことで、処理内容も自然と整理されていきます。

初心者の方は、「このURLは誰のためのページか」を意識してルーティングを考えると理解しやすくなります。例えば一般ユーザー向けのページと、管理者だけが使うページを分けることで、後から機能を追加するときも迷いにくくなります。


func userHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "ユーザー情報ページです")
}

func adminHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "管理者専用ページです")
}

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/user", userHandler)
    mux.HandleFunc("/admin", adminHandler)
    http.ListenAndServe(":8080", mux)
}

この例では、/userにアクセスするとユーザー向けの処理が呼ばれ、 /adminにアクセスすると管理者向けの処理が実行されます。 URLごとに役割を分けることで、コードの意味も読み取りやすくなります。小さなアプリでも、この考え方を取り入れておくと、後で規模が大きくなったときに役立ちます。

4. ポイント整理

ここまで見てきたように、Go言語でWebアプリを作るときは、 http.ServeMuxを使うことでURLごとの処理を分かりやすく整理できます。 URLとハンドラー関数をセットで管理できるため、「このURLでは何をしているのか」がコードを見ただけで把握しやすくなります。これは、プログラミング未経験者や初心者の方にとって大きな安心材料になります。

ServeMuxを使ったルーティングは、標準ライブラリだけで完結し、特別な設定や難しい知識がなくても始められるのが特徴です。まずは少ないページ構成からスタートし、ページが増えるたびにURLと処理を追加していくことで、自然とWebアプリの全体構造を理解できるようになります。


func main() {
    mux := http.NewServeMux()

    // ページごとにURLと処理を対応させる
    mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintln(w, "トップページです")
    })

    mux.HandleFunc("/contact", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintln(w, "お問い合わせページです")
    })

    http.ListenAndServe(":8080", mux)
}

このように、URLと処理をひとつずつ結びつけていくことで、 Webアプリの動きが直感的に理解できるようになります。 ServeMuxを使った基本的なルーティングの考え方を身につけておくと、今後のGo言語でのWebアプリ開発がスムーズに進められるようになります。

5. デフォルトのServeMuxとの違い

Go言語のnet/httpパッケージには、あらかじめ用意されている「デフォルトのServeMux」が存在します。ふだん何気なくhttp.HandleFuncを使うと、実はこのデフォルトのServeMuxにURLとハンドラーが登録されています。小さなサンプルや動作確認では手軽で便利ですが、ページが増えてくると「このURL、どこで登録したんだっけ？」と探しにくくなることがあります。

一方で、http.NewServeMux()を使って自分でServeMuxを作ると、そのServeMuxの中だけでルーティングを管理できます。つまり「このサーバーはこのルールで動く」と範囲がはっきりするため、ファイルを分けたり機能を追加したりするときも見通しが良くなります。初心者の方ほど、最初から明示的にServeMuxを作る書き方に慣れておくと安心です。

違いをイメージするなら、デフォルトのServeMuxは「共用の受付」にどんどん案内板を貼っていく感じで、明示的なServeMuxは「自分の受付」を用意して、そこにだけ案内板をまとめる感覚です。 Webアプリの規模が大きくなるほど、この差が効いてきます。


package main

import (
    "fmt"
    "net/http"
)

func main() {
    // 明示的にServeMuxを作る（このmuxの中だけで管理できる）
    mux := http.NewServeMux()

    mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintln(w, "トップページです")
    })

    mux.HandleFunc("/help", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintln(w, "ヘルプページです")
    })

    http.ListenAndServe(":8080", mux)
}

このようにServeMuxを変数として持っておくと、ルーティングがまとまって見えるので、「URLごとの処理を整理したい」という目的にぴったりです。まずはデフォルトと明示的なServeMuxの違いを知っておくだけでも、 Go言語のWebサーバー開発で迷いにくくなります。

6. ServeMuxでのURLマッチングの考え方

ServeMuxでは、アクセスされたURLパスをもとにして、あらかじめ登録しておいたハンドラーの中から「最も適切なもの」を自動的に選びます。このとき、単純な完全一致だけでなく、 URLの構造を考慮したマッチングが行われる点が特徴です。そのため、URL設計を意識することで、ルーティングをより分かりやすく整理できます。

特に重要なのが、/user/のようにスラッシュで終わるパスです。この形式で登録しておくと、その配下にあるURL、たとえば/user/profileや/user/settingといったアクセスも、同じハンドラーでまとめて受け取ることができます。初心者の方は「フォルダの中身をまとめて扱う」イメージを持つと理解しやすいです。


package main

import (
    "fmt"
    "net/http"
)

func userHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "ユーザー関連ページです")
}

func main() {
    mux := http.NewServeMux()

    // /user/ 配下のURLをまとめて処理する
    mux.HandleFunc("/user/", userHandler)

    http.ListenAndServe(":8080", mux)
}

この例では、/user/だけでなく、 /user/profileや/user/settingにアクセスしても、すべてuserHandlerが呼ばれます。 URLの構成をそろえておくことで、処理の流れが自然につながり、 Webアプリ全体の見通しも良くなります。

まずはシンプルなURLから始めて、ページ数が増えてきたら「どのURLをまとめられるか」を考えてみましょう。 ServeMuxのURLマッチングの仕組みを理解しておくと、 Go言語でのWebアプリ設計がよりスムーズに進められるようになります。

7. Webアプリ設計とServeMuxの相性

ServeMuxは、Go言語でWebアプリを設計する際の「入口整理役」としてとても相性が良い存在です。 URLと処理の対応関係がはっきりするため、「このURLは何のためのページなのか」「どの処理が動くのか」を直感的に把握できます。プログラムに慣れていない方でも、URLを見るだけでアプリの構成を想像しやすくなります。

小さなアプリではシンプルなルーティングでも十分ですが、ページ数や機能が増えてくると、設計の分かりやすさが重要になります。 ServeMuxを使ってURLごとに役割を分けておくことで、後から機能を追加するときも既存のコードを壊しにくくなります。これは個人開発だけでなく、将来コードを読み返すときにも助けになります。


func main() {
    mux := http.NewServeMux()

    // 機能ごとにURLを分けて設計する
    mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintln(w, "トップページ")
    })

    mux.HandleFunc("/blog", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintln(w, "ブログ一覧ページ")
    })

    http.ListenAndServe(":8080", mux)
}

このようにURLと機能を意識して設計しておくと、 Webアプリ全体の構造が自然と整理されます。 ServeMuxを前提にした設計に慣れておくことで、 Go言語でのWebアプリ開発を安心して進められるようになります。

Go言語を基礎からスッキリ学びたい人や、文法だけでなく「実用的な使い方」まで押さえたい人には、定番の入門書がこちらです。

基礎からわかるGo言語をAmazonで見る

※ Amazon広告リンク

まとめ

http.ServeMuxを使ったルーティングの振り返り

この記事では、Go言語の標準ライブラリに含まれている http.ServeMux を使って、 Webアプリにおけるルーティングをどのように実装するのかを、基礎から丁寧に確認してきました。 Webアプリ開発では、URLごとに処理を分けることが当たり前のように行われますが、初心者の方にとっては「どこで分岐しているのか」「どの処理が呼ばれているのか」が分かりにくく感じることも少なくありません。 ServeMuxは、その悩みをとてもシンプルな形で解決してくれる仕組みです。

http.NewServeMux() を使ってルーターを作成し、 HandleFunc でURLパスとハンドラー関数を結び付ける。たったそれだけの手順で、URLごとに異なる処理を返せるWebサーバーが完成します。外部ライブラリに頼らず、Go言語だけで完結する点は、学習コストを抑えたい初心者にとって大きなメリットと言えるでしょう。また、標準ライブラリであるため情報も多く、公式ドキュメントやサンプルを参考にしやすい点も安心材料です。

ServeMuxを使ったルーティングでは、「URLは処理への入口である」という考え方を自然に身に付けることができます。 /hello にアクセスしたら挨拶を返す、 /about にアクセスしたら説明ページを返す、 /user や /admin のように役割ごとにURLを分ける。こうした構成は、実際のWebサービスでもそのまま使われています。この記事で紹介した内容は、シンプルではありますが、本格的なWebアプリ開発につながる大切な基礎になっています。

ServeMuxを使った最小構成のサンプル

ここで改めて、ServeMuxを使った最小構成のサンプルを振り返ってみましょう。 URLと処理の関係を整理するイメージを持ちながら読むと、 ServeMuxの役割がよりはっきり見えてきます。


package main

import (
    "fmt"
    "net/http"
)

func topHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "トップページです")
}

func contactHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "お問い合わせページです")
}

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/", topHandler)
    mux.HandleFunc("/contact", contactHandler)
    http.ListenAndServe(":8080", mux)
}

このように、ServeMuxにURLとハンドラーを登録していくだけで、複数ページを持つWebアプリを簡単に作成できます。 URLが増えても、処理が整理されているため、コード全体の見通しが悪くなりにくいのが特徴です。初心者のうちは、まずこの形をしっかり理解することが重要です。

先生と生徒の振り返り会話

生徒

「ServeMuxを使うと、URLごとに処理を分けるのがすごく分かりやすいですね。今まで何となく書いていたコードの意味が、少しずつ理解できてきました。」

先生

「それは良いですね。ServeMuxはGo言語のWeb開発における基本中の基本です。 URLと処理の関係を整理する感覚は、どんな規模のアプリでも役立ちます。」

生徒

「外部ライブラリを使わなくても、ここまでできるのは意外でした。まずは標準ライブラリをしっかり理解することが大事なんですね。」

先生

「その通りです。最初から難しい仕組みに手を出すより、標準ライブラリでできることを理解してから次に進む方が、結果的に近道になります。 ServeMuxを理解できたら、他のルーティング方法もスムーズに学べますよ。」

生徒

「まずはServeMuxで小さなWebアプリをいくつか作ってみます。今日学んだことを復習しながら、URL設計にも慣れていきたいです。」

先生

「それが一番です。実際に手を動かしながら学ぶことで、 Go言語のWeb開発がどんどん楽しくなっていきますよ。」

【超入門】ゼロから始めるGo言語プログラミング：最速で「動くアプリ」を作るマンツーマン指導

「プログラミングの仕組み」が根本からわかる。Go言語でバックエンド開発の第一歩を。

本講座を受講することで、単なる文法の暗記ではなく、「プログラムがコンピュータの中でどう動いているか」という本質的な理解につながります。シンプルながら強力なGo言語（Golang）を通じて、現代のバックエンドエンジニアに求められる基礎体力を最短距離で身につけます。

具体的な開発内容と環境

【つくるもの】
ターミナル（黒い画面）上で動作する「対話型計算プログラム」や、データを整理して表示する「ミニ・ツール」をゼロから作成します。自分の書いたコードが形になる感動を体験してください。

【開発環境】
プロの現場でシェアNo.1のVisual Studio Code (VS Code)を使用します。インストールから日本語化、Go言語用の拡張機能設定まで、現場基準の環境を一緒に構築します。

この60分で得られる3つの理解

1. 環境構築の完全な理解

「なぜ動くのか」という設定の仕組みを理解し、今後の独学で詰まらない土台を作ります。

2. Go言語の基本構造（変数・型）

データの種類やメモリの概念など、他言語にも通じるプログラミングの本質を学びます。

3. 読みやすいコードの書き方

ただ動くだけでなく、誰が見ても分かりやすい「綺麗なコード」を書くための考え方を伝授します。

※本講座は、将来的にバックエンドエンジニアやクラウドインフラに興味がある未経験者のためのエントリー講座です。マンツーマン形式により、あなたの理解度に合わせて進行します。

初めてのGo言語を一緒に学びましょう！

詳細・お申し込みはこちら