Troubleshooting

Login administrativo em loop

1. Verifique resposta do POST de login.
2. Confirme Set-Cookie e cookie ecommpanel_session.
3. Consulte linha em panel_sessions e expiração.
4. Confirme que /ecommpanel/admin é dinâmica (ƒ no build).
5. Resposta autenticada não pode conter x-nextjs-prerender.
6. Valide user-agent e horário do servidor.

Conteúdo diferente entre local e produção

1. Compare commit e branch.
2. Confirme banco, usuário e modo de persistência.
3. Consulte registro no PostgreSQL.
4. Revise projeção publicada e data de geração.
5. Rebuild não corrige dado ausente no banco.

Build falha por permissão

O build não deve escrever no runtime externo nem criar tabelas. Procure acesso ao banco durante phase-production-build, diretório pertencente a outro usuário ou artefato .next-build sem permissão.

Upload falha

Confirme formato, limite, sharp, espaço livre, leitura/escrita da pasta pública e da pasta de metadados. O painel de saúde mostra caminhos efetivos.

API retorna 401 ou 403

• 401: sessão, token ou cliente inválido;
• 403: escopo, permissão, CSRF, origem ou IP;
• verifique expiração e rotação;
• consulte logs de integração sem expor segredo.

PostgreSQL indisponível

Confirme serviço, porta, firewall local, credenciais, banco, grants e limite de conexões. Produção deve responder 503 para domínio autoritativo indisponível, não cair silenciosamente para mock.