logo
GeekFormat

Consulta de códigos de status HTTP

Códigos de Status de Alta Frequência

Resultados da pesquisa (77)

100
1xx
Continue
已收到请求头，客户端应继续发送请求体
101
1xx
Switching Protocols
服务器正按 Upgrade 切换协议（如 WebSocket）
102
1xx
Processing
已接受请求，处理尚未结束（WebDAV）
103
1xx
Early Hints
在最终响应前返回 Link 等提示以预加载资源
104
1xx
Upload Resumption Supported
表明支持可恢复上传（IANA 临时注册，详见 httpbis 可恢复上传草案）
200
2xx
OK
请求成功
201
2xx
Created
已创建资源
202
2xx
Accepted
已接受，尚未处理完成（异步任务常见）
203
2xx
Non-Authoritative Information
成功，表示可能来自代理/缓存
204
2xx
No Content
成功，无响应体
205
2xx
Reset Content
成功，客户端应重置文档或表单视图
206
2xx
Partial Content
成功返回部分内容（Range）
207
2xx
Multi-Status
多状态 XML响应（WebDAV）
208
2xx
Already Reported
DAV 绑定成员已在先前响应中列出（WebDAV）
226
2xx
IM Used
已应用实例操作（Delta 编码，RFC 3229）
300
3xx
Multiple Choices
多种表示可选，需选择或重定向
301
3xx
Moved Permanently
资源永久迁移至新 URI
302
3xx
Found
资源临时位于其他 URI
303
3xx
See Other
应使用 GET 访问另一 URI 获取结果
304
3xx
Not Modified
缓存仍有效
305
3xx
Use Proxy
须经由代理（已弃用，不建议实现）
306
3xx
(Unused)
历史占位，HTTP/1.1 起未使用
307
3xx
Temporary Redirect
临时重定向，方法与正文不变
308
3xx
Permanent Redirect
永久重定向，方法与正文不变
400
4xx
Bad Request
语法无效，无法解析
401
4xx
Unauthorized
需身份验证（常配合 WWW-Authenticate）
402
4xx
Payment Required
预留，极少实现
403
4xx
Forbidden
拒绝访问（与401 不同：未必缺凭证）
404
4xx
Not Found
未找到资源
405
4xx
Method Not Allowed
该 URI 不支持此 HTTP 方法
406
4xx
Not Acceptable
无法生成 Accept 可接受的表示
407
4xx
Proxy Authentication Required
需先通过代理认证
408
4xx
Request Timeout
等待请求超时
409
4xx
Conflict
与资源当前状态冲突
410
4xx
Gone
资源曾存在且已永久移除
411
4xx
Length Required
缺少有效 Content-Length 等
412
4xx
Precondition Failed
前置条件（如 If-*）不满足
413
4xx
Content Too Large
请求体过大（RFC 9110 用语）
414
4xx
URI Too Long
URI 过长
415
4xx
Unsupported Media Type
不支持的媒体类型
416
4xx
Range Not Satisfiable
无法满足 Range
417
4xx
Expectation Failed
无法满足 Expect 头
418
4xx
(Unused)
RFC 9110 标记未使用；典故为 RFC 2324「I'm a teapot」
421
4xx
Misdirected Request
请求未指向能响应的服务器/连接（如 HTTP/2）
422
4xx
Unprocessable Content
语义可理解但无法处理（校验失败等）
423
4xx
Locked
资源被锁定（WebDAV）
424
4xx
Failed Dependency
依赖请求失败（WebDAV）
425
4xx
Too Early
拒绝可能重放的过早请求
426
4xx
Upgrade Required
需升级到 Upgrade 指定的协议
428
4xx
Precondition Required
源站要求条件请求以防冲突
429
4xx
Too Many Requests
请求过于频繁，应限速
431
4xx
Request Header Fields Too Large
请求头整体或单项过大
444
vendor
No Response (nginx)
Nginx 直接关连接不返回状态行（常见于限流/屏蔽）
451
4xx
Unavailable For Legal Reasons
因法律原因不可提供
495
vendor
SSL Certificate Error (nginx)
Nginx：客户端证书校验失败
496
vendor
SSL Certificate Required (nginx)
Nginx：需要客户端证书
497
vendor
HTTP to HTTPS Port (nginx)
Nginx：向 HTTPS 端口发送明文 HTTP
499
vendor
Client Closed Request (nginx)
客户端在响应完成前关闭连接
500
5xx
Internal Server Error
服务器内部错误
501
5xx
Not Implemented
不支持该方法或能力
502
5xx
Bad Gateway
网关从上游收到无效响应
503
5xx
Service Unavailable
过载或维护，暂不可用
504
5xx
Gateway Timeout
网关等待上游超时
505
5xx
HTTP Version Not Supported
不支持请求中的 HTTP 版本
506
5xx
Variant Also Negotiates
透明协商配置错误
507
5xx
Insufficient Storage
存储空间不足（WebDAV）
508
5xx
Loop Detected
检测到循环（WebDAV）
510
5xx
Not Extended
需扩展（RFC 2774 实验状态，IANA 标为 OBSOLETED，可忽略）
511
5xx
Network Authentication Required
需在网络层认证（如强制门户）
520
vendor
Unknown Error (Cloudflare)
源站返回异常或空响应
521
vendor
Web Server Is Down (Cloudflare)
无法与源站建立 TCP
522
vendor
Connection Timed Out (Cloudflare)
与源站握手或连接超时
523
vendor
Origin Is Unreachable (Cloudflare)
无法路由到源站
524
vendor
A Timeout Occurred (Cloudflare)
源站已连接但未及时返回完整响应
525
vendor
SSL Handshake Failed (Cloudflare)
与源站 SSL 握手失败
526
vendor
Invalid SSL Certificate (Cloudflare)
源站证书无效
527
vendor
Railgun Error (Cloudflare)
Railgun 边缘到源监听错误（Cloudflare 专用）

Ferramenta gratuita de referência de códigos de status HTTP com cobertura completa das 5 categorias: 1xx Informativo/2xx Sucesso/3xx Redirecionamento/4xx Erro do Cliente/5xx Erro do Servidor, além de extensões de fornecedores. Suporta filtragem por categoria e pesquisa por palavras-chave, essencial para desenvolvimento e depuração.

Sugestões Relacionadas

Verificador de Security Headers

Verificador de Certificados SSL

Verificador de HTTP Headers

Gerador de cabeçalhos CORS

Verificador de Cadeia de Redirecionamento

Casos de uso

  • Depuração Web/API: Quando erros ocorrem em APIs, pesquise rapidamente o significado dos códigos de status para determinar a direção da solução (parâmetros de frontend ou bug de backend?)
  • Solução de problemas de integração de API: Distinguir falha de autenticação 401, permissões insuficientes 403, endereço incorreto 404, erro do servidor 500
  • Solução de falhas operacionais: Ao encontrar erros 502/503/504/522/524 localize rapidamente causas e soluções
  • Trabalho de SEO: Verificar se tipos de redirecionamento 301/302 estão corretos, verificar se tratamento de páginas de erro 404 é adequado
  • Aprendizado do protocolo HTTP: Iniciantes aprendem sistematicamente as categorias de códigos HTTP e o propósito de cada código
  • Preparação para entrevistas: Entrevistas frontend/backend frequentemente perguntam diferenças 301 vs 302, 401 vs 403, 502 vs 504
  • Análise de logs: Entender o significado de cada código de status ao analisar logs de acesso do Nginx/Apache/CDN

Recursos

  • Cobertura completa: Códigos padrão 1xx-5xx + extensões de fornecedores Cloudflare/Nginx (5xx vendor), tudo em um só lugar
  • Cartões de acesso rápido: 12 códigos mais usados (200/301/302/304/400/401/403/404/429/500/502/503) — clique nos cartões para ver detalhes diretamente
  • Filtragem por categoria: Filtragem com um clique por categorias 1xx/2xx/3xx/4xx/5xx/vendor para localizar rapidamente tipos de problemas
  • Pesquisa por palavras-chave: Suporta pesquisa difusa por número de código, nome em inglês ou descrição para localizar rapidamente o código alvo
  • Codificação por cores: 2xx verde (sucesso), 3xx/4xx amarelo (atenção/problemas do cliente), 5xx vermelho (problemas do servidor) para julgamento visual intuitivo
  • Tabela no desktop/cartões no mobile: Visualização de tabela completa no desktop, visualização de cartões responsiva no mobile para excelente experiência em todos os dispositivos
  • Cópia com um clique do resumo filtrado: Copie as condições de filtro atuais e contagem de resultados para tickets/documentação

Como Usar

  1. Basta digitar o número do código de status (ex: 404) ou palavra-chave (ex: redirect, forbidden, timeout) na caixa de pesquisa
  2. Ou clique nos botões de categoria (1xx/2xx/3xx/4xx/5xx/vendor) para navegar por categoria
  3. Clique nos cartões de códigos frequentes para filtrar rapidamente esse código
  4. Visualize o nome do código de status, cor da categoria e descrição detalhada
  5. Clique no botão de cópia para copiar o resumo filtrado atual para registros de solução de problemas

Perguntas frequentes

O que são códigos de status HTTP e para que servem?

Códigos de status HTTP são códigos numéricos de três dígitos retornados por servidores em resposta a requisições HTTP, indicando se a requisição teve sucesso, falhou ou requer ação adicional. São divididos em 5 categorias: 1xx Informativo, 2xx Sucesso, 3xx Redirecionamento, 4xx Erro do Cliente, 5xx Erro do Servidor. Durante desenvolvimento e depuração, os códigos de status indicam rapidamente a direção do problema: 2xx sucesso sem ação necessária; 4xx verificar parâmetros da requisição/autenticação/permissões/limites de taxa; 5xx verificar logs do servidor.

Qual é a diferença exata entre redirecionamentos 301 e 302?

Diferença chave: 301 é um **redirecionamento permanente** — navegadores/motores de busca cacheiam o novo endereço e autoridade SEO é transferida para a nova URL; 302 é um **redirecionamento temporário** — não é cacheado e não há transferência de autoridade. Há também uma diferença importante na mudança de método: historicamente 301/302 mudavam POST para GET (comportamento impreciso), enquanto 307/308 mantêm estritamente o método de requisição original. Use 301 para redirecionamentos HTTPS, migrações de domínio, mudanças permanentes de URL; use 302 ou 307 para redirecionamentos de manutenção temporária e páginas de campanha.

Qual é a diferença entre 401 e 403?

401 Unauthorized significa 'não autenticado' — o servidor não sabe quem você é, você precisa primeiro fazer login/fornecer um Token (geralmente acompanhado do cabeçalho WWW-Authenticate); 403 Forbidden significa 'autenticado mas sem permissão' — o servidor sabe quem você é, mas você não tem permissão para acessar este recurso. Em termos simples: 401 é 'você não trouxe seu cartão de acesso', 403 é 'você tem cartão de acesso mas não pode entrar nesta sala'.

Qual é a diferença entre 502, 503 e 504?

Todos são erros do servidor mas com causas diferentes: 502 Bad Gateway significa que o proxy reverso recebeu uma **resposta inválida** do upstream (travamento de backend/erro de protocolo); 503 Service Unavailable significa que o servidor está **temporariamente indisponível** (sobrecarga/manutenção/serviço não iniciado); 504 Gateway Timeout significa que o servidor proxy **atingiu timeout esperando o upstream** (backend processando muito devagar/consultas lentas no BD). Ao solucionar: para 502 verifique se processos de backend estão vivos e logs de erros; para 503 verifique estado do serviço/limites de taxa/páginas de manutenção; para 504 verifique desempenho do backend/consultas lentas/configuração de timeout.

Quando devo usar 200 OK vs 204 No Content?

200 OK é a resposta de sucesso padrão e pode retornar um corpo de resposta (ex: resultados de consulta, dados de recurso criado); 204 No Content indica sucesso mas **não retorna corpo de resposta**, comumente usado para DELETE bem-sucedido, atualizações PUT/POST bem-sucedidas onde dados não precisam ser retornados. Uma resposta 204 não deve conter body.

Como tratar o código de limite de taxa 429?

429 Too Many Requests significa que o cliente excedeu o limite de frequência de requisições do servidor. A resposta geralmente inclui um cabeçalho Retry-After indicando quantos segundos esperar antes de tentar novamente. Clientes devem implementar backoff exponencial (Exponential Backoff): esperar 1 segundo na primeira tentativa, 2 segundos na segunda, 4 segundos na terceira... Verifique também os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset para conhecer as cotas de limite de taxa.

O que são códigos de extensão de fornecedores, como os 520-527 da Cloudflare?

Códigos de status HTTP padrão são definidos apenas na faixa 100-599 e a maioria é registrada na IANA, mas fornecedores de CDN/proxy definem extensões personalizadas: Cloudflare define a série 520-527 para problemas de conexão com a origem (521 origem recusou, 522 timeout de conexão, 524 timeout de resposta etc.); Nginx define o 499 (cliente fechou conexão). Esses códigos não são códigos HTTP padrão mas aparecem frequentemente na solução de problemas operacionais reais, e esta ferramenta inclui códigos de extensão de fornecedores comumente usados.

O que são códigos de status HTTP?

Códigos de status HTTP (HTTP Status Code) são códigos numéricos de três dígitos retornados por servidores ao responder a requisições HTTP, indicando o resultado do processamento — teve sucesso ou falhou? Em caso de falha foi problema do cliente ou do servidor? É necessário redirecionamento? Esta é uma das informações de diagnóstico mais fundamentais e importantes no desenvolvimento e operações web.

Os códigos de status são divididos em 5 categorias pelo primeiro dígito: **1xx Resposta informativa** (requisição recebida, processamento continuando, raro na prática); **2xx Sucesso** (requisição processada com sucesso, o mais comum é 200 OK); **3xx Redirecionamento** (ação adicional do cliente necessária, ex: 301 redirecionamento permanente, 302 redirecionamento temporário, 304 cache hit); **4xx Erro do cliente** (problema com a requisição, ex: 400 parâmetros incorretos, 401 não logado, 403 sem permissão, 404 não encontrado, 429 limite de taxa); **5xx Erro do servidor** (servidor falhou no processamento, ex: 500 erro interno, 502 Bad Gateway, 503 indisponível, 504 timeout).

**Por que distinguir entre 4xx e 5xx?** Este é o julgamento de primeira prioridade na solução de problemas: ao ver 4xx você deve primeiro verificar sua própria requisição — a URL está correta, os parâmetros estão completos, o Token foi incluído, as permissões são suficientes, as requisições são muito frequentes?; ao ver 5xx você precisa verificar os logs do servidor — os processos de backend estão saudáveis, o banco de dados está conectado, a configuração está correta, há sobrecarga?. Errar a direção desperdiça muito tempo de depuração.

**As diferenças entre códigos de redirecionamento são um tópico frequente em exames**: 301 é redirecionamento permanente (transferência de autoridade SEO, cache do navegador), 302 é redirecionamento temporário (sem transferência de autoridade), 307/308 mantêm estritamente o método de requisição (POST não é convertido em GET). Na prática use 301 para redirecionamentos HTTPS e migrações de domínio, 302 para manutenção temporária, 303 para redirecionamentos após envio de formulário POST (padrão PRG).

Esta ferramenta **inclui completamente** todos os códigos de status HTTP padrão (incluindo os facilmente confundíveis como 303/307/308, 405/409/422/429 etc.) bem como códigos de extensão de fornecedores comumente usados de Cloudflare/Nginx (520-527, 499). Suporta filtragem por categoria, pesquisa por palavras-chave e cartões de acesso rápido — uma ferramenta de referência diária essencial para depuração de desenvolvimento, solução de problemas de API e localização de falhas operacionais.

术语表

HTTP
HyperText Transfer Protocol, o protocolo fundamental para comunicação de dados na World Wide Web, baseado em TCP/IP, usando um modelo requisição-resposta. As versões principais atuais são HTTP/1.1 e HTTP/2, com HTTP/3 baseado em QUIC.
Idempotência (Idempotence)
Executar a mesma requisição múltiplas vezes tem o mesmo efeito que executá-la uma vez. GET/HEAD/PUT/DELETE/OPTIONS/TRACE são idempotentes; POST não é idempotente (múltiplos envios criam múltiplos recursos). Uma razão importante pela qual 307/308 preservam o método é manter a idempotência.
CORS (Compartilhamento de Recursos de Origem Cruzada)
Cross-Origin Resource Sharing, um mecanismo para acesso entre origens sob a política de mesma origem do navegador. Requisições preflight CORS (OPTIONS) podem retornar 405 Method Not Allowed ou erros relacionados a CORS, um dos problemas mais comuns no desenvolvimento frontend.
Padrão PRG (Post/Redirect/Get)
Melhor prática para envio de formulários web: Após enviar um formulário com POST, retornar um redirecionamento 303 See Other para a página de resultados, evitando envios duplicados quando o usuário atualiza. Este é o caso de uso mais típico do 303.
Retry-After
Cabeçalho de resposta HTTP usado com 503 Service Unavailable ou 429 Too Many Requests para informar aos clientes quantos segundos esperar antes de tentar a requisição novamente.
WWW-Authenticate
Cabeçalho de resposta HTTP usado com 401 Unauthorized para informar aos clientes qual esquema de autenticação usar (Basic/Bearer/Digest etc.) e o âmbito de autenticação.
ETag / If-None-Match
Mecanismo de validação de cache. O servidor retorna um ETag identificando a versão do recurso; clientes enviam o cabeçalho If-None-Match em requisições subsequentes, e se o recurso não mudou o servidor retorna 304 Not Modified (sem body, economizando largura de banda).
Proxy reverso (Reverse Proxy)
Um servidor proxy (como Nginx, Cloudflare, HAProxy) situado entre clientes e servidores backend, recebendo requisições de clientes e encaminhando-as para backends, depois retornando respostas dos backends aos clientes. Erros 502/503/504 ocorrem todos entre o proxy reverso e o backend.

Visão geral das 5 categorias de códigos de status HTTP

ClasseSignificadoPropósitoCódigos comuns
1xxResposta informativa (Informational)Requisição recebida, processamento continuando (estado intermediário do protocolo)100 Continue, 101 Switching Protocols
2xxResposta de sucesso (Success)A requisição foi recebida, compreendida e aceita com sucesso pelo servidor200 OK, 201 Created, 204 No Content, 206 Partial Content
3xxRedirecionamento (Redirection)Ação adicional do cliente é necessária para completar a requisição301 Moved Permanently, 302 Found, 304 Not Modified, 307/308
4xxErro do cliente (Client Error)A requisição contém erro de sintaxe ou não pode ser atendida, culpa do cliente400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests
5xxErro do servidor (Server Error)O servidor falhou em atender uma requisição aparentemente válida, culpa do servidor500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable, 504 Gateway Timeout

Comparação de códigos de redirecionamento frequentes (301/302/303/307/308)

CódigoNomePermanenteMudança de métodoCacheávelCaso de uso típico
301Moved Permanently✅ PermanentePOST pode virar GET (compatibilidade histórica)✅ Cacheado por padrãoRedesign do site, migração de domínio, HTTP→HTTPS, URLs antigas obsoletas
302Found❌ TemporárioPOST pode virar GET (compatibilidade histórica)❌ Não cacheado por padrãoRedirecionamento de manutenção temporária, páginas de campanha, testes A/B
303See Other❌ TemporárioPOST→GET (mudança explícita)❌ Não cacheado por padrãoRedirecionar para página de resultados após envio de formulário POST (padrão PRG)
307Temporary Redirect❌ TemporárioMantém estritamente o método original❌ Não cacheado por padrãoRedirecionamento temporário que mantém estritamente o método e o body da requisição
308Permanent Redirect✅ PermanenteMantém estritamente o método original✅ Cacheado por padrãoRedirecionamento permanente que impede POST de ser convertido em GET

Guia de solução de erros comuns do cliente

CódigoSignificadoCausas comunsDireção de solução
400Bad RequestErro de sintaxe na requisição/parâmetros faltando/erro de formato JSON/headers muito grandesVerificar parâmetros da requisição, Content-Type, codificação URL
401UnauthorizedNão autenticado/Token expirado/cabeçalho Authorization faltandoVerificar estado de login, expiração do Token, formato do cabeçalho Bearer
403ForbiddenAutenticado mas sem permissão/IP bloqueado/CSRF Token inválido/WAF bloqueadoVerificar permissões de usuário, lista branca de IP, regras WAF, CSRF Token
404Not FoundURL não existe/recurso excluído/erro de configuração de roteamentoVerificar ortografia da URL, configuração de rotas, se o recurso foi excluído
405Method Not AllowedMétodo de requisição incorreto (ex: usar POST em endpoint que só aceita GET)Verificar métodos HTTP (GET/POST/PUT/DELETE etc.), preflight CORS
408Request TimeoutCliente enviando requisição muito devagar/latência de rede/configuração de timeout do servidor muito curtaVerificar conexão de rede, aumentar timeout, upload em lotes
409ConflictConflito de recursos (ex: criação duplicada, conflito de versão, modificação simultânea)Verificar envios duplicados, usar bloqueio otimista/chaves de idempotência
413Payload Too LargeArquivo enviado/corpo da requisição excede o limite do servidorVerificar client_max_body_size do nginx, comprimir arquivos, upload fragmentado
422Unprocessable EntityFormato da requisição correto mas erro semântico (ex: falha na validação de campos)Validação de parâmetros API RESTful, verificar campos obrigatórios, tipos de dados, formatos
429Too Many RequestsLimite de taxa atingido/frequência de requisições muito altaReduzir frequência de requisições, adicionar backoff de retentativa, solicitar cota maior

Erros comuns do servidor e códigos de extensão Cloudflare

CódigoSignificadoCausas comuns
500Internal Server ErrorExceção no código do servidor/erro não capturado/falha na conexão com banco de dados/erro de configuração
501Not ImplementedO servidor não suporta a funcionalidade solicitada (ex: método HTTP não suportado)
502Bad GatewayProxy reverso (nginx/CDN) recebeu resposta inválida do upstream/processo de backend travou/PHP-FPM não iniciado
503Service UnavailableServidor sobrecarregado/em manutenção/serviço de backend não iniciado/pool de conexões esgotado
504Gateway TimeoutProxy reverso atingiu timeout esperando resposta do upstream/backend processando muito devagar/consultas lentas no BD
520Web Server Returned Unknown Error (CF)Cloudflare: Origem retornou resposta desconhecida/anormal (erro de protocolo/resposta vazia/sem código de status)
521Web Server Is Down (CF)Cloudflare: Servidor de origem recusou conexão (origem fora do ar/firewall bloqueando IPs do CF)
522Connection Timed Out (CF)Cloudflare: Não é possível estabelecer conexão TCP com a origem (firewall de origem/grupos de segurança/iptables)
523Origin Is Unreachable (CF)Cloudflare: IP de origem inacessível (servidor de origem não existe/problemas de roteamento)
524A Timeout Occurred (CF)Cloudflare: Conexão TCP bem-sucedida mas origem atingiu timeout retornando resposta HTTP (>100s), comum com consultas lentas/tarefas longas
499Client Closed Request (Nginx)Código de extensão Nginx: Cliente fechou conexão antes do servidor responder (usuário cancelou/timeout de frontend)

Authoritative References