Repository navigation
Diagnóstico
Gabriel Leandro edited this page Oct 17, 2026
·
4 revisions
Problemas clássicos e a saída de cada um:
| Sintoma | Causa | Saída |
|---|---|---|
EADDRINUSE / "porta já está em uso" |
Processo órfão na :4010
|
netstat -ano | findstr 4010 → taskkill /PID <n> /F, ou troque port em config.json
|
GET /users 404 com schemas válidos |
dist/ desatualizado no host |
npm run build --workspaces + Ctrl+R no host F5 |
| Switch sem efeito | Cenário ativo sem definição (versões antigas) | Atualize para versão com cenários embutidos |
Rota /userss
|
Model digitado no plural | Desde a correção, nomes em s não ganham outro s
|
config.json inválido |
JSON quebrado | Mensagem acionável + exit 1 (nunca stack) |
| Export acusa stale | Algum artefato não está sincronizado com o Schema | Reexporte Tudo — o stale é por artefato (export parcial não sincroniza os demais) |
Muitos 500 aleatórios nas respostas |
errorRate > 0 em config.json
|
Zere errorRate (0–100) para voltar ao comportamento normal |
balance string na API real |
Backend fora do contrato | Breaking — corrija o backend ou o Schema e reexporte |
Nada aqui resolveu? Veja Correções (bugs já corrigidos por versão) ou abra uma issue com os passos.