Go言語でミドルウェアを作成する方法と活用例！初心者でもわかるWebアプリ開発

1. Go言語のミドルウェアとは？

1. Go言語のミドルウェアとは？

Go言語におけるミドルウェアとは、HTTPリクエストとレスポンスの間で共通処理を行う関数のことです。標準ライブラリのhttp.Handlerを使って簡単に作ることができます。例えば、すべてのリクエストにログを出力したい場合、ミドルウェアを作ると一箇所で処理をまとめられます。

2. 基本的なミドルウェアの作成方法

2. 基本的なミドルウェアの作成方法

ミドルウェアは、http.HandlerFuncを引数に取り、同じ型のhttp.HandlerFuncを返す関数として作成します。これにより、元のハンドラーに前処理や後処理を追加できます。

package main

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

// ログを出力するミドルウェア
func loggingMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        fmt.Printf("リクエスト: %s %s\n", r.Method, r.URL.Path)
        next.ServeHTTP(w, r)
        fmt.Printf("処理時間: %v\n", time.Since(start))
    }
}

func helloHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "こんにちは、ミドルウェアの世界！")
}

func main() {
    http.HandleFunc("/hello", loggingMiddleware(helloHandler))
    http.ListenAndServe(":8080", nil)
}

この例では、loggingMiddlewareがリクエスト前にログを出力し、リクエスト処理後に処理時間を表示しています。元のハンドラーhelloHandlerはそのまま使えます。

3. ミドルウェアの活用例

3. ミドルウェアの活用例

ミドルウェアはログだけでなく、認証やエラーハンドリング、共通ヘッダーの追加など幅広く活用できます。

// 認証チェックミドルウェア
func authMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        token := r.Header.Get("Authorization")
        if token != "secret" {
            http.Error(w, "認証エラー", http.StatusUnauthorized)
            return
        }
        next.ServeHTTP(w, r)
    }
}

func secretHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "認証に成功しました！")
}

func main() {
    http.HandleFunc("/secret", authMiddleware(secretHandler))
    http.ListenAndServe(":8080", nil)
}

上の例では、authMiddlewareでAuthorizationヘッダーをチェックし、不正な場合はアクセスを拒否しています。これにより、共通の認証処理を複数のハンドラーに簡単に適用できます。

4. 複数のミドルウェアを組み合わせる方法

4. 複数のミドルウェアを組み合わせる方法

複数のミドルウェアを順番に適用したい場合、ミドルウェアを入れ子にすることで簡単に実現できます。

http.HandleFunc("/secure", loggingMiddleware(authMiddleware(secretHandler)))

この場合、リクエストはまずauthMiddlewareで認証をチェックされ、通過した場合にloggingMiddlewareでログが記録され、最後にsecretHandlerが実行されます。順番を変えることで、処理の流れを柔軟に制御できます。

5. レスポンスヘッダーを操作するミドルウェア

5. レスポンスヘッダーを操作するミドルウェア

ミドルウェアを使うと、すべてのレスポンスに共通のHTTPヘッダーを追加することもできます。 例えば、文字コードの指定やセキュリティ関連のヘッダーを付与することで、 Webアプリ全体の挙動を統一できます。 各ハンドラーに同じ設定を書く必要がなくなるため、管理が非常に楽になります。

func headerMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Content-Type", "text/plain; charset=utf-8")
        next.ServeHTTP(w, r)
    }
}

func sampleHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "ヘッダーが設定されています")
}

func main() {
    http.HandleFunc("/header", headerMiddleware(sampleHandler))
    http.ListenAndServe(":8080", nil)
}

この例では、すべてのレスポンスに文字コード付きのContent-Typeを設定しています。 ブラウザ表示の文字化け防止にも役立つ、実用的なミドルウェアの一例です。

6. エラーハンドリングを共通化するミドルウェア

6. エラーハンドリングを共通化するミドルウェア

Webアプリでは、想定外のエラーが発生することもあります。 ミドルウェアを使えば、エラー処理を一箇所にまとめて管理できます。 panicが発生した場合でも、アプリ全体が停止しないように制御することが可能です。

func recoverMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if err := recover(); err != nil {
                http.Error(w, "サーバーエラーが発生しました", http.StatusInternalServerError)
            }
        }()
        next.ServeHTTP(w, r)
    }
}

func errorHandler(w http.ResponseWriter, r *http.Request) {
    panic("強制エラー")
}

func main() {
    http.HandleFunc("/error", recoverMiddleware(errorHandler))
    http.ListenAndServe(":8080", nil)
}

このようにしておくと、エラー発生時にもユーザーに分かりやすいレスポンスを返せます。 安定したWebサーバーを作るために覚えておきたい考え方です。

7. ミドルウェアの適用範囲を意識する

7. ミドルウェアの適用範囲を意識する

ミドルウェアは非常に便利ですが、すべてのハンドラーに無条件で適用する必要はありません。 ログや認証など、用途に応じて適用範囲を意識することが大切です。 必要なルートだけにミドルウェアを適用することで、無駄な処理を減らせます。

http.HandleFunc("/public", helloHandler)
http.HandleFunc("/private", authMiddleware(helloHandler))

この例では、公開ページと認証が必要なページを分けています。 ミドルウェアの役割を考えながら設計することで、分かりやすいWebアプリになります。

8. ミドルウェアを理解すると広がるWebアプリ設計

8. ミドルウェアを理解すると広がるWebアプリ設計

ミドルウェアの仕組みを理解すると、Go言語でのWebアプリ設計の幅が大きく広がります。 認証、ログ、エラー処理、ヘッダー管理などを分離して考えられるようになるため、 コードの見通しが良くなり、保守もしやすくなります。

最初はシンプルなログ出力から始め、 徐々に認証やエラーハンドリングへと応用していくのがおすすめです。 ミドルウェアはWebアプリ開発の基礎となる重要な概念なので、 実際に手を動かしながら理解を深めていきましょう。

まとめ

まとめ

ミドルウェアを通して学んだGo言語Webアプリ開発の考え方

この記事では、Go言語を使ったWebアプリ開発において欠かせない「ミドルウェア」という仕組みについて、 基本的な考え方から具体的な実装方法、実践的な活用例までを段階的に学んできました。 ミドルウェアとは、HTTPリクエストがハンドラーに届く前、そしてレスポンスが返る後のタイミングで、 共通の処理を挟み込むための仕組みです。 ログ出力、認証チェック、エラーハンドリング、レスポンスヘッダーの制御など、 Webアプリ全体に共通する処理を一箇所にまとめられる点が大きな特徴です。

特に初心者にとって重要なのは、ミドルウェアを使うことで 「同じコードを何度も書かなくてよくなる」という点を実感することです。 例えば、すべてのページでアクセスログを残したい場合、 各ハンドラーにログ処理を書くのではなく、 ミドルウェアとして一度定義するだけで済みます。 これによりコードの重複が減り、可読性と保守性が大きく向上します。

ミドルウェア設計で意識したいポイント

ミドルウェアを設計する際には、「どこまでを共通処理として切り出すか」を意識することが大切です。 すべての処理をミドルウェアに詰め込みすぎると、逆に流れが分かりにくくなってしまいます。 ログ、認証、エラー処理など、役割が明確なものからミドルウェア化していくと、 自然と整理された構成になります。

また、複数のミドルウェアを組み合わせる場合は、 適用する順番にも注意が必要です。 認証チェックを先に行うのか、ログを先に残すのかによって、 実行結果やログの内容が変わることがあります。 実際にリクエストの流れをイメージしながら設計することが、 安定したWebアプリを作るためのコツです。

ミドルウェアを使ったシンプルな最終サンプル

package main

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

func loggingMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        fmt.Println("アクセス:", r.Method, r.URL.Path)
        next.ServeHTTP(w, r)
        fmt.Println("処理時間:", time.Since(start))
    }
}

func helloHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "ミドルウェア付きWebサーバーです")
}

func main() {
    http.HandleFunc("/", loggingMiddleware(helloHandler))
    http.ListenAndServe(":8080", nil)
}

このサンプルでは、ログ出力用のミドルウェアを使って、 すべてのアクセスに対して共通のログ処理を行っています。 非常にシンプルな構成ですが、 ミドルウェアの基本的な役割と効果を確認するには十分な例です。 ここから認証やエラーハンドリングを追加していくことで、 実用的なWebアプリへと発展させることができます。