À quoi sert le middleware de Next.js ?

Question

Accepted Answer

**Middleware** est du code qui s'exécute **avant qu'une requête soit complétée** — sur l'Edge, avant que la page ou le gestionnaire de route ne soit rendu. Il vous permet d'inspecter et de réécrire/rediriger les requêtes, de définir des en-têtes, ou de vérifier l'authentification pour de nombreuses routes au même endroit.

## Définir le 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*"] };
```

## Ce que le middleware peut faire

```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.
```

Usages courants : **authentification gatekeeping**, **redirects** (basées sur la locale/géolocalisation, www→apex), **A/B testing** via rewrites, définition d'**en-têtes de sécurité**, et flags de bot/feature.

## Contraintes clés

```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
```

La config `matcher` est importante : limitez le middleware uniquement aux routes qui en ont besoin, afin qu'il ne s'exécute pas sur les assets statiques et ne ralentisse tout.

## Pourquoi c'est important

Le middleware est le point d'étranglement unique pour la logique de requête transversale — authentification redirects, routage par locale, rewrites, et en-têtes — appliqué à de nombreuses routes sans répéter le code dans chaque page.

Connaître ses contraintes Edge (rapide, pas d'API Node, vérifications légères uniquement) et le scoping `matcher` est ce qui vous permet de l'utiliser correctement pour les préoccupations de gatekeeping et de routage.