Páginas

Temas

Ferramentas

↑↓navegar↵abrirescfechar
Codificação e segurança

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.

Busca rápida
42 códigosCada entrada mostra a causa, o comando para verificar agora e se vale a pena tentar de novo.
  • 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/health
    • curl -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/items
    • echo '{"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/me
    • curl -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/42
    • curl -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.zip
    • curl -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-after
    • sleep 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/items
    • docker 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-after
    • docker 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/slow
    • psql "$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 100
    • kubectl 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 3000
    • ss -ltnp | grep 3000
    • docker 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/items
    • curl -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> 443
    • curl -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.com
    • nslookup 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 :3000
    • kill -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.

    • id
    • ls -ld /var/lib/app
    • PORT=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 ferramenta
Meu 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.

Todos os guias de Linux