📖
Next.js

Middleware

Função Edge que intercepta requests antes de chegar na rota. Para auth, redirects, headers.

📚 O que é

Roda em Edge Runtime (V8 isolate, CDN global). Executa ANTES de SSG/SSR/Route Handler. Pode redirecionar, reescrever URL, modificar headers/cookies. Configure matcher para filtrar rotas.

✅ Quando usar

Autenticação e autorização. Redirects baseados em auth/geolocation/A-B testing. Adicionar headers de segurança (CSP, HSTS). Internacionalização (locale routing).

🚫 Quando NÃO usar

Operações pesadas ou que requerem Node.js completo. Queries diretas ao banco (use Server Component). Lógica de negócio complexa.

👍 Prós
Roda no edge (baixa latência global)
Antes de qualquer render
Controle total do request/response
Suporte a cookies/headers
👎 Contras
Edge Runtime = APIs limitadas
Sem Node.js modules
Sem Prisma/drivers de DB diretos
Cada request tem overhead
🔗 Termos relacionados
Server Component (RSC)
Next.js

Componente que renderiza exclusivamente no servidor. Sem JS no bundle do cliente.

Server Action
Next.js

Função 'use server' que executa no servidor mas pode ser chamada pelo cliente. Sem API route.

SSG
Next.js

Static Site Generation. HTML gerado em build-time. Servido como arquivo estático do CDN.

SSR
Next.js

Server-Side Rendering. HTML gerado a cada request. Dados sempre frescos.

ISR
Next.js

Incremental Static Regeneration. SSG com revalidação automática em background.

Edge Runtime
Next.js

V8 isolates em CDN edge global. Baixa latência, APIs Web restritas, sem Node.js.

App Router
Next.js

Sistema de rotas do Next.js 13+ baseado em /app/. Suporta RSC, Server Actions, Layouts, Streaming.