Next.js のミドルウェアは何に使うのですか？

Question

Accepted Answer

**Middleware** は **リクエストが完了する前に実行される** コード — Edge 上で、ページまたはルートハンドラーがレンダリングされる前に実行されます。リクエストを検査して書き換え/リダイレクトしたり、ヘッダーを設定したり、多くのルートの認証を 1 箇所でチェックできます。

## Defining middleware

```ts
// middleware.ts (at the project root)
import { NextRequest, NextResponse } from "next/server";

export function middleware(req: NextRequest) {
  const token = req.cookies.get("session")?.value;

// protect /dashboard — redirect unauthenticated users to login
  if (req.nextUrl.pathname.startsWith("/dashboard") && !token) {
    return NextResponse.redirect(new URL("/login", req.url));
  }
  return NextResponse.next(); // allow the request to proceed
}

// only run on these paths (performance — don't run on every asset)
export const config = { matcher: ["/dashboard/:path*", "/account/:path*"] };
```

## What middleware can do

```ts
NextResponse.redirect(url);          // send the user elsewhere (auth gates)
NextResponse.rewrite(url);           // serve different content, URL unchanged (A/B, i18n)
NextResponse.next();                  // continue, optionally with modified headers
// req.geo / req.cookies / req.headers — inspect location, auth, etc.
```

一般的な用途: **認証ゲーティング**、**リダイレクト** (ロケール/地域ベース、www→apex)、rewrite による **A/B テスト**、**セキュリティヘッダー** の設定、ボット/フィーチャーフラグ。

## Key constraints

```text
⚠️ Runs on the EDGE runtime → no Node.js APIs (no fs, limited libraries)
⚠️ Must be FAST — it runs before every matched request; heavy work adds latency
⚠️ Can't access the database directly for complex auth — do lightweight checks
   (e.g. verify a JWT/cookie exists); do full auth in the page/handler
```

`matcher` 設定は重要です: ミドルウェアをそれが必要なルートだけに限定し、静的アセット上で実行されず、すべてが遅くなるのを防ぎます。

## なぜ重要なのか

ミドルウェアは、クロスカッティング リクエストロジック — 認証リダイレクト、ロケールルーティング、rewrite、ヘッダー — の単一の抑制ポイントで、各ページでコードを繰り返さずに多くのルートに適用されます。

Edge の制約 (高速、Node API なし、軽量チェックのみ) と `matcher` スコーピングを理解することが、ゲートキーピングとルーティングの問題に正しく使用できる鍵です。