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.