ミドルウェアパターン

Webアプリケーションでは、リクエスト処理の前後にすべてのリクエストに共通して行いたい処理があります。例えば、「アクセスログを出す」「ログイン済みか確認する」などが該当します。これを毎回ハンドラ関数の中に書くと同じコードが繰り返しになり、追加や変更のたびに全ハンドラを書き換える手間がかかります。

このような共通処理を、実際のハンドラから切り離して外側にまとめる仕組みがミドルウェアです。ミドルウェアは、リクエストが届いた直後やレスポンスを返す直前に共通処理を差し込めるようにする層として機能します。リクエストとハンドラの間に、共通処理の層をひとつ挟む形になります。

リクエスト → [ミドルウェア: 前処理] → [ハンドラ本体] → [ミドルウェア: 後処理] → レスポンス

net/http では、ミドルウェアは「元の http.Handler を受け取り、共通処理を挟み込んだ新しい http.Handler を返す関数」として書きます。それにより、ログ出力や認証などの共通処理をひとつのミドルウェアにまとめてハンドラ群に一括で適用でき、必要に応じてミドルウェアを重ねて組み合わせることが行えるようになります。

1. ミドルウェアの実装例

書き方は以下のとおりです。

func ミドルウェア名(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // 前処理
        next.ServeHTTP(w, r)   // 次のハンドラへ
        // 後処理
    })
}

これは、リクエストの処理時間をログに出す loggingMiddleware を作り、それで mux 全体をラップするコードです。

package main

import (
    "fmt"
    "log"
    "net/http"
    "time"
)

func loggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        next.ServeHTTP(w, r)
        log.Printf("%s %s (%s)", r.Method, r.URL.Path, time.Since(start))
    })
}

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

    mux.HandleFunc("GET /health", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintln(w, "ok")
    })

    handler := loggingMiddleware(mux)

    fmt.Println("http://localhost:8080 で起動")
    http.ListenAndServe(":8080", handler)
}

main.go を上記の内容で置き換えて保存します。既存のサーバが動いている場合は Ctrl+C で停止し、以下のコマンドで再起動します。

go run main.go

別のターミナルで以下のコマンドを実行します。

curl http://localhost:8080/health

サーバを起動しているターミナル側に、以下のようなログが出力されます。

2026/07/29 12:00:00 GET /health (123.456µs)

/health へのリクエストが処理されたあと、ミドルウェアがメソッド(GET)、パス(/health)、処理時間をまとめてログに書き出しています。

コードを解説します。

func loggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        next.ServeHTTP(w, r)
        log.Printf("%s %s (%s)", r.Method, r.URL.Path, time.Since(start))
    })
}

loggingMiddleware は http.Handler を受け取り、ラップした http.Handler を返します。中では「開始時刻を記録」→「次のハンドラ(next)を呼ぶ」→「所要時間をログに出す」という流れになっています。

handler := loggingMiddleware(mux)
http.ListenAndServe(":8080", handler)

ListenAndServe に渡すのは、mux を loggingMiddleware でラップした handler です。これで全てのリクエストが自動でログに残るようになります。