0

Cookies e headers no App Router do Next.js: 7 regras pra não cair em dynamic routes sem querer

No App Router, um cookie lido no lugar errado vira a rota inteira dinâmica. Estas sete regras evitam surpresa no deploy.

1. Leia cookies só onde a dinâmica é aceitável

Se a página pode ser estática, não chame cookies() no Server Component raiz. Empurre a leitura para um trecho que realmente precisa de sessão.

2. Prefira headers explícitos a “pegar tudo”

headers() também marca a árvore como dinâmica. Use só o header que importa.

3. Auth de página ≠ auth de mutation

Checagem de sessão na UI pode ser leve. Escrita (Server Action / Route Handler) precisa validar de novo no servidor.

4. Não compartilhe o cliente Supabase entre server e client sem pensar

No server use o helper SSR; no client o browser client. Misturar vaza expectativa de cookie.

5. Cache e revalidate depois do login

Depois do sign-in, invalide o que depende do usuário. Preview logado vs deslogado pega regressão cedo.

6. Edge vs Node por rota

Helpers de cookie/crypto mudam no Edge. Declare runtime de propósito.

7. Smoke test com dois personas

Um passe deslogado e um logado no preview evitam “na minha máquina funciona”.


Fonte: trabalho no Massvai, um AI app builder de apps full-stack Next.js + Supabase + Vercel. Divulgação: faço parte do time Massvai.

Carregando publicação patrocinada...