Status e códigos de saída
Busca em um só lugar códigos de status HTTP, códigos de saída do Docker e do Kubernetes e valores errno de rede. Cada entrada mostra a causa, o comando para verificar na hora e se vale a pena tentar de novo.
Roda totalmente no seu navegador: nada do que você cola é enviado.
- 200OKPode repetirHTTP
A requisição deu certo e o corpo traz o resultado. Um 200 com corpo vazio geralmente vem de um cache ou de um ramo de fallback.
curl -i https://example.com/api/healthcurl -sS https://example.com/api/health | head -c 200- A mesma requisição pode ser repetida como está.
- 201CreatedNão repetirHTTP
A requisição criou um recurso. O cabeçalho Location aponta para o novo registro, e a ausência dele é o motivo comum de o cliente não conseguir seguir adiante.
curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/items- Repetir a mesma requisição devolve a mesma resposta.
- 204No ContentNão repetirHTTP
A requisição deu certo e a resposta não tem corpo. Código que sempre analisa JSON falha aqui com fim inesperado de JSON.
curl -i -X DELETE https://example.com/api/items/42- Repetir a mesma requisição devolve a mesma resposta.
- 301Moved PermanentlyPode repetirHTTP
A URL mudou em definitivo e os clientes guardam o redirecionamento em cache. Use só quando o caminho antigo não volta; uma mudança temporária fica em 302 ou 307.
curl -sSIL https://example.com/old-path- A mesma requisição pode ser repetida como está.
- 302FoundPode repetirHTTP
É um redirecionamento temporário, mas os clientes podem trocar POST por GET. Se a API precisa manter o método, use 307 ou 308.
curl -sSIL https://example.com/login- A mesma requisição pode ser repetida como está.
- 304Not ModifiedPode repetirHTTP
A cópia em cache ainda é válida, então nenhum corpo é enviado. Só aparece com If-None-Match ou If-Modified-Since e, no log, não é erro.
curl -i -H 'If-None-Match: "etag"' https://example.com/page- A mesma requisição pode ser repetida como está.
- 307Temporary RedirectPode repetirHTTP
Redirecionamento temporário que mantém o método e o corpo, exatamente o que um POST para outra URL precisa.
curl -sSIL -X POST https://example.com/api/old- A mesma requisição pode ser repetida como está.
- 308Permanent RedirectPode repetirHTTP
Redirecionamento permanente que mantém o método e o corpo. O navegador guarda em cache, então um destino errado é difícil de desfazer.
curl -sSIL https://example.com/old- A mesma requisição pode ser repetida como está.
- 400Bad RequestRepetir após corrigirHTTP
O servidor não conseguiu ler a requisição: JSON quebrado, campo obrigatório ausente ou Content-Type errado. Quase todo framework aponta no corpo qual campo falhou.
curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/itemsecho '{"name":"test"}' | python3 -m json.tool- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 401UnauthorizedRepetir após corrigirHTTP
A autenticação está ausente ou inválida: sem cabeçalho Authorization, token expirado ou esquema errado. O cabeçalho WWW-Authenticate mostra o que o servidor espera.
curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/mecurl -sSI https://example.com/api/me | grep -i www-authenticate- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 403ForbiddenRepetir após corrigirHTTP
A sessão está autenticada mas não tem permissão. Verifique papel ou escopo, política do bucket ou da tabela e a lista de IPs permitidos; um 403 após o login é permissão, não token.
curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/admin- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 404Not FoundNão repetirHTTP
O caminho ou o registro não existe. Confira a rota, a barra final, a URL base e o id; um proxy que corta o prefixo do caminho dá a mesma resposta.
curl -sSIL https://example.com/api/items/42curl -sS http://localhost:3000/api- Repetir a mesma requisição devolve a mesma resposta.
- 405Method Not AllowedRepetir após corrigirHTTP
A rota existe, mas não para este método: um GET em um endpoint só de POST ou um proxy ou formulário que trocou o método. O cabeçalho Allow lista o que é aceito.
curl -i -X GET https://example.com/api/items- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 408Request TimeoutPode repetirHTTP
O cliente não enviou a requisição inteira a tempo. Costuma ser upload lento em conexão fraca ou timeout do proxy menor que o cliente precisa.
curl -sS -o /dev/null -w '%{time_total}s\n' https://example.com/api/upload- A mesma requisição pode ser repetida como está.
- 409ConflictRepetir após corrigirHTTP
A requisição conflita com o estado atual: chave única duplicada, duas gravações na mesma linha ou versão de bloqueio otimista diferente. Vale reler e tentar de novo.
curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"a@b.c"}' https://example.com/api/users- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 413Payload Too LargeRepetir após corrigirHTTP
O corpo passa de um limite do servidor ou de quem está à frente: client_max_body_size do nginx, teto de requisição de serverless ou limite do framework. Comprima ou envie em partes.
du -h ./upload.zipcurl -i -F 'file=@upload.zip' https://example.com/api/upload- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 415Unsupported Media TypeRepetir após corrigirHTTP
O Content-Type não é o que o endpoint aceita. O caso comum é enviar corpo JSON como formulário; use application/json e mantenha o JSON válido.
curl -i -X POST -H 'Content-Type: application/json' -d '{"a":1}' https://example.com/api/items- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 422Unprocessable EntityRepetir após corrigirHTTP
O formato está certo, mas os valores não passaram na validação. FastAPI, Rails e Laravel devolvem os erros de campo no corpo, então leia antes de mudar a requisição.
curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"nope"}' https://example.com/api/users- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 429Too Many RequestsPode repetirHTTP
Um limite de requisições ou uma cota foi atingido. Leia o Retry-After, espere com jitter e veja qual chave está limitada: IP, chave de API ou usuário logado.
curl -sSI https://example.com/api/items | grep -i retry-aftersleep 5 && curl -i https://example.com/api/items- A mesma requisição pode ser repetida como está.
- 500Internal Server ErrorPode repetirHTTP
O servidor lançou um erro que não trata. A pilha está no log do servidor, e um 500 que só aparece em uma rota aponta para aquele handler, não para a rede.
curl -i https://example.com/api/itemsdocker compose logs -f --tail 50 api- A mesma requisição pode ser repetida como está.
- 502Bad GatewayPode repetirHTTP
O proxy chegou ao upstream mas não recebeu resposta utilizável: a aplicação caiu ou está reiniciando, escuta em outra porta ou responde HTTP em uma porta TLS.
curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' https://example.com/docker compose ps- A mesma requisição pode ser repetida como está.
- 503Service UnavailablePode repetirHTTP
O servidor está de pé mas não consegue atender: sobrecarga, manutenção, uma dependência falhando ou nenhuma instância saudável atrás do balanceador. O Retry-After diz quando voltar.
curl -sSI https://example.com/ | grep -i retry-afterdocker compose ps- A mesma requisição pode ser repetida como está.
- 504Gateway TimeoutPode repetirHTTP
O proxy esperou o upstream além do seu timeout. Olhe consultas lentas, índice ausente, proxy_read_timeout ou o limite de execução da função antes do código.
curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' http://localhost:3000/api/slowpsql "$DATABASE_URL" -c 'EXPLAIN ANALYZE SELECT 1'- A mesma requisição pode ser repetida como está.
- 0Exit 0 — successPode repetirContêiner e saída
O processo terminou com sucesso. É o esperado em uma tarefa única e um erro em um serviço que deve continuar no ar, então confira se o entrypoint termina e sai.
docker logs --tail 50 <container>docker inspect --format '{{.State.ExitCode}}' <container>- A mesma requisição pode ser repetida como está.
- 1Exit 1 — application errorRepetir após corrigirContêiner e saída
A aplicação em si falhou: exceção não tratada, asserção falhada ou migração ausente. O motivo está nas últimas linhas do log do contêiner.
docker logs --tail 100 <container>docker inspect --format '{{.State.ExitCode}}' <container>- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 2Exit 2 — usage errorRepetir após corrigirContêiner e saída
O comando de shell ou a linha de comando está errada: opção inválida, argumento ausente ou arquivo ilegível no script de entrada.
docker logs --tail 50 <container>docker run --rm -it --entrypoint sh <image>- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 126Exit 126 — cannot executeRepetir após corrigirContêiner e saída
O comando existe mas não pode ser executado: falta permissão de execução, o shebang tem quebra de linha do Windows ou o interpretador não está na imagem.
docker run --rm -it --entrypoint sh <image> -c 'ls -l /entrypoint.sh'file /path/to/entrypoint.sh- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 127Exit 127 — command not foundRepetir após corrigirContêiner e saída
O comando não está no PATH da imagem: erro de digitação, pacote que nunca foi instalado ou binário que só existe em outro estágio do build multistage.
docker run --rm -it --entrypoint sh <image> -c 'command -v node'docker run --rm -it --entrypoint sh <image> -c 'echo $PATH'- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 130Exit 130 — SIGINTPode repetirContêiner e saída
O processo parou com Ctrl-C, 128 mais o sinal 2. É normal em um contêiner que você interrompeu à mão; se acontece sem ninguém no terminal, investigue.
docker inspect --format '{{.State.ExitCode}}' <container>- A mesma requisição pode ser repetida como está.
- 137Exit 137 — SIGKILL / OOMKilledRepetir após corrigirContêiner e saída
O contêiner foi morto com 128 mais o sinal 9. Na maioria das vezes o OOM killer agiu, então compare o pico de memória da aplicação com o limite antes de aumentá-lo.
docker inspect --format '{{.State.OOMKilled}}' <container>docker stats --no-stream <container>kubectl describe pod <pod> | grep -i -A2 'Last State'- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 139Exit 139 — SIGSEGVRepetir após corrigirContêiner e saída
O processo morreu com falha de segmentação, 128 mais o sinal 11. É comum com módulo nativo compilado para outra libc ou ABI de Node ou Python diferente.
docker logs --tail 100 <container>docker inspect --format '{{.Config.Image}}' <container>- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- 143Exit 143 — SIGTERMPode repetirContêiner e saída
O contêiner recebeu SIGTERM, 128 mais o sinal 15, que é o pedido normal de parada. Se se repete sozinho, a aplicação não conclui o encerramento no prazo.
docker inspect --format '{{.Config.StopTimeout}}' <container>docker logs --tail 50 <container>- A mesma requisição pode ser repetida como está.
- CrashLoopBackOffKubernetes CrashLoopBackOffRepetir após corrigirContêiner e saída
O Kubernetes reinicia o contêiner porque ele termina sem parar e a espera entre tentativas cresce. A saída da tentativa anterior explica a saída.
kubectl logs <pod> --previous --tail 100kubectl describe pod <pod> | grep -i -A5 'Last State'- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- ImagePullBackOffKubernetes ImagePullBackOffRepetir após corrigirContêiner e saída
A imagem não pode ser baixada: tag inexistente, registro privado sem imagePullSecrets ou registro limitando requisições do nó.
kubectl describe pod <pod> | sed -n '/Events/,$p'kubectl get secret <secret> -o yaml- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- CreateContainerConfigErrorKubernetes CreateContainerConfigErrorRepetir após corrigirContêiner e saída
O contêiner não pode ser criado porque falta algo que ele referencia: um Secret ou ConfigMap, uma de suas chaves ou o volume que o carrega.
kubectl describe pod <pod> | sed -n '/Events/,$p'kubectl get secret,configmap- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- EvictedKubernetes EvictedRepetir após corrigirContêiner e saída
O pod foi despejado porque o nó ficou sem memória, disco ou processos. Requests e limits que não refletem o uso real e um nó sem espaço livre são as causas comuns.
kubectl get pod <pod> -o jsonpath='{.status.reason}{"\\n"}{.status.message}{"\\n"}'kubectl describe node <node> | grep -i -A6 'Conditions'- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- ECONNREFUSEDECONNREFUSEDPode repetirErrno de rede
Nada está escutando nesse host e porta, ou escuta apenas em 127.0.0.1. Dentro do Docker o host é o nome do serviço, não localhost, e a porta é a do contêiner.
nc -vz localhost 3000ss -ltnp | grep 3000docker compose ps- A mesma requisição pode ser repetida como está.
- ECONNRESETECONNRESETPode repetirErrno de rede
O outro lado fechou a conexão no meio da requisição: o par caiu ou expirou, um proxy ou balanceador encerrou uma conexão ociosa ou HTTP foi enviado a uma porta TLS.
curl -v https://example.com/api/itemscurl -v --http1.1 --keepalive-time 30 https://example.com/- A mesma requisição pode ser repetida como está.
- ETIMEDOUTETIMEDOUTPode repetirErrno de rede
Nenhuma resposta chegou a tempo: roteamento, firewall ou security group, host errado ou par lento demais. Teste a porta antes de mexer no código.
nc -vz -w 5 <host> 443curl -sS -o /dev/null -w '%{time_connect}s %{time_total}s\n' https://example.com/- A mesma requisição pode ser repetida como está.
- ENOTFOUNDENOTFOUNDRepetir após corrigirErrno de rede
O nome do host não foi resolvido: erro de digitação, domínio de busca ausente, contêiner sem DNS ou resolvedor limitando requisições.
getent hosts api.example.comnslookup api.example.com 1.1.1.1- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- EADDRINUSEEADDRINUSERepetir após corrigirErrno de rede
A porta já está ocupada nesta máquina: outro processo ou uma instância anterior que nunca terminou.
lsof -i :3000kill -15 $(lsof -t -i :3000)- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
- EACCESEACCESRepetir após corrigirErrno de rede
Permissão negada: porta abaixo de 1024 sem privilégio ou um arquivo ou diretório que o processo não pode escrever. Em contêineres costuma ser usuário não root com volume do root.
idls -ld /var/lib/appPORT=8080 node server.js- Tente de novo depois de corrigir a causa; repetir agora não muda nada.
Referência de status e códigos de saída
referência rápida- 4xx vs 5xx
- Um 4xx indica algo a corrigir na requisição do cliente e um 5xx uma falha do servidor; um 502 ou 504 em uma única rota quase sempre vem do upstream atrás do proxy.
- 128 + signal
- O shell informa um processo encerrado por sinal como 128 mais o número do sinal: 137 é 128+9 (SIGKILL), 143 é 128+15 (SIGTERM) e 139 é 128+11 (SIGSEGV).
- OOMKilled
- Um 137 com OOMKilled true no docker inspect significa que o limite de memória foi atingido; um limite abaixo do pico da aplicação reinicia o contêiner do mesmo jeito.
- CrashLoopBackOff
- O Kubernetes reinicia o contêiner porque ele termina sem parar; kubectl logs --previous mostra a tentativa que falhou.
- ECONNREFUSED
- Nada está escutando nesse host e porta; dentro do Docker o host é o nome do serviço, não localhost, e a porta é a do contêiner.
- Retry-After
- É o cabeçalho que um 429 ou 503 envia para dizer quando voltar; espere com jitter em vez de repetir em loop apertado.
Perguntas frequentes
respostas abaixo da ferramentaMeu contêiner saiu com 137. O que é?
137 é 128 + 9, SIGKILL: ou o sistema matou por falta de memória, ou foi um docker stop. O OOMKilled no docker inspect separa os casos.
O que é CrashLoopBackOff?
O Kubernetes reinicia o contêiner porque ele termina sem parar; kubectl logs --previous mostra por que a última tentativa morreu.
Posso repetir um 503?
Sim, com espera progressiva: costuma ser problema temporário do upstream ou de capacidade, e o Retry-After diz quanto esperar.
Guias de sintaxe de Linux
Todos os guias de LinuxLinux: Too many open files (EMFILE) and ulimit
EMFILE is a per-process descriptor limit, ENFILE is the kernel's. Read the limit from /proc, raise it in the right layer, and find the leak that made it matter.
Linuxsystemd status=203/EXEC and 217/USER: Exec and Permission Failures
203 is a failed execve, 217 is a user systemd could not resolve. Both happen before your program runs, and the check that finds each takes one command.
Linuxsystemd Timers vs Cron: Missing PATH, Overlapping Runs, Time Drift
Cron runs a bare shell with no profile and no locking, and systemd reads the system time zone. The environment, single-instance and schedule fixes for both.
LinuxBash Indexed Arrays, Associative Maps, and Parameter Expansion
Quoting decides whether an array stays a list, and the expansion operators replace most external text tools. Includes set -u, mapfile, namerefs, and the bash 3.2 differences that break scripts on macOS.