Como interpretar os erros
O que cada tipo de mensagem quer dizer e onde procurar a causa real.
Intermediário·5 min de leitura
Erros no console da aplicação
| Mensagem | O que é | O que fazer |
|---|---|---|
| Cannot find module / ModuleNotFoundError | Dependência não instalada. | Declare no arquivo de dependências e publique de novo. |
| EADDRINUSE | Duas partes do código tentaram abrir a mesma porta. | Garanta um único listen na aplicação. |
| ECONNREFUSED | Um serviço externo (banco, API) recusou a conexão. | Confira endereço, porta e se o serviço está de pé. |
| JavaScript heap out of memory | O processo estourou a memória. | Aumente a memória ou reduza o que é carregado de uma vez. |
| 401 / 403 de uma API externa | Credencial errada, expirada ou sem permissão. | Verifique a variável de ambiente e as permissões da chave. |
Erros que aparecem para o visitante do site
| Status | Significado | Onde investigar |
|---|---|---|
| 404 | A rota não existe na aplicação. | Confira o caminho e se o arquivo subiu no pacote. |
| 500 | O seu código lançou uma exceção. | O rastro está no console, na aba Logs. |
| 502 / 503 | A aplicação não respondeu. | Ela caiu, está reiniciando ou não escuta na porta certa. |
| 504 | A resposta demorou demais. | Alguma operação está travando — normalmente uma consulta lenta. |
Na dúvida, pergunte ao assistente
O assistente de IA lê o log real da sua aplicação e explica o erro em português, apontando a linha. Ele está na aba Assistente IA, dentro da aplicação.
Continue lendo
Problemas comuns
Os oito casos que respondem pela maioria dos chamados, com a causa e a correção de cada um.
ReactorAI
A assistente que lê o console e os arquivos da sua aplicação antes de responder.
Relatórios de acesso e desempenho
Quantas pessoas entraram, de onde vieram, o que deu erro e quanto tempo esperaram.