¿Para qué se utiliza el middleware de Next.js?

Question

Accepted Answer

**Middleware** es código que se ejecuta **antes de que se complete una solicitud** — en Edge, antes de que se renderice la página o el manejador de rutas. Te permite inspeccionar y reescribir/redirigir solicitudes, establecer encabezados o verificar autenticación para muchas rutas en un solo lugar.

## Definiendo 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*"] };
```

## Qué puede hacer el middleware

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

Usos comunes: **autenticación de acceso**, **redirecciones** (basadas en locale/geolocalización, www→apex), **pruebas A/B** mediante rewrites, configurar **encabezados de seguridad** y flags de bots/características.

## Restricciones clave

```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 configuración `matcher` es importante: limita el middleware solo a las rutas que lo necesitan, para que no se ejecute en activos estáticos y ralentice todo.

## Por qué es importante

Middleware es el único punto de control para la lógica de solicitud transversal — redirecciones de autenticación, enrutamiento de locale, rewrites y encabezados — aplicados en muchas rutas sin repetir código en cada página.

Conocer sus restricciones en Edge (rápido, sin APIs de Node, solo comprobaciones ligeras) y el alcance del `matcher` es lo que te permite usarlo correctamente para problemas de gatekeeping y enrutamiento.