<!-- Erros 4xx: lista de códigos, significado, 4xx vs 5xx, 408 — Uptimely -->
> Markdown version of https://getuptimely.com/pt-BR/errors/4xx — the page itself is the canonical copy.

Guia de erros

# Erros 4xx de cliente

A classe de respostas que indica que o problema estava na requisição. Para um monitor, um 4xx geralmente significa que a verificação está mal configurada.

Erros 4xx são a classe de códigos de status HTTP de erro do cliente, de 400 a 499\. Um 4xx diz que o servidor entendeu a requisição e a recusou porque o problema era a própria requisição: malformada, sem autorização, apontada para algo que não existe ou usando um método que não é permitido. O servidor está funcionando e respondendo. Ele está dizendo que a pergunta estava errada.

Os códigos que você mais vai encontrar são 400 Bad Request (a requisição estava malformada), 401 Unauthorized (nenhuma credencial válida foi enviada), 403 Forbidden (o acesso é recusado, com ou sem credenciais), 404 Not Found (não há nada nesse caminho), 405 Method Not Allowed, 410 Gone e 429 Too Many Requests. Cada um tem uma correção diferente, então leia o código exato antes de qualquer outra coisa.

Isso torna a classe incomum no monitoramento. Um 4xx em uma verificação normalmente aponta para a verificação, não para o serviço. Um monitor que recebe 401 perdeu suas credenciais. Um que recebe 404 aponta para um caminho que mudou. Um que recebe 405 está usando o método errado. Acionar o plantão por isso gera um alerta sobre uma configuração de monitoramento, o tipo de alerta que ensina as pessoas a ignorar alertas.

Dois códigos da classe quebram essa regra e merecem ser tratados como falhas reais. Um 429 significa que o servidor está descartando carga de propósito, um sinal de capacidade sobre o serviço. Um 408 significa que o servidor desistiu de esperar a requisição chegar, o que geralmente diz mais sobre a rede ou a carga do próprio servidor do que sobre o cliente. Os dois têm guias próprios.

4xx versus 5xx se resume a quem o código de status culpa. Um 4xx culpa a requisição, um 5xx diz que o servidor falhou em uma requisição que parecia válida, e só o primeiro dígito decide a classe (RFC 9110). Por isso 408 Request Timeout, que muitas vezes é arquivado junto com os erros de servidor por falar em timeout, é um 4xx: o servidor esgotou o tempo esperando o cliente terminar de enviar. Um timeout enquanto se espera um servidor upstream é, em vez disso, o 5xx 504.

__Lista de códigos de erro 4xx: todo erro de cliente registrado e onde ele é definido__
| Código | Nome                            | Definido em           |
| ------ | ------------------------------- | --------------------- |
| 400    | Bad Request                     | RFC 9110              |
| 401    | Unauthorized                    | RFC 9110              |
| 402    | Payment Required (reserved)     | RFC 9110              |
| 403    | Forbidden                       | RFC 9110              |
| 404    | Not Found                       | RFC 9110              |
| 405    | Method Not Allowed              | RFC 9110              |
| 406    | Not Acceptable                  | RFC 9110              |
| 407    | Proxy Authentication Required   | RFC 9110              |
| 408    | Request Timeout                 | RFC 9110              |
| 409    | Conflict                        | RFC 9110              |
| 410    | Gone                            | RFC 9110              |
| 411    | Length Required                 | RFC 9110              |
| 412    | Precondition Failed             | RFC 9110              |
| 413    | Content Too Large               | RFC 9110              |
| 414    | URI Too Long                    | RFC 9110              |
| 415    | Unsupported Media Type          | RFC 9110              |
| 416    | Range Not Satisfiable           | RFC 9110              |
| 417    | Expectation Failed              | RFC 9110              |
| 418    | (Unused)                        | RFC 9110              |
| 421    | Misdirected Request             | RFC 9110              |
| 422    | Unprocessable Content           | RFC 9110              |
| 423    | Locked                          | RFC 4918 (WebDAV)     |
| 424    | Failed Dependency               | RFC 4918 (WebDAV)     |
| 425    | Too Early                       | RFC 8470              |
| 426    | Upgrade Required                | RFC 9110              |
| 428    | Precondition Required           | RFC 6585              |
| 429    | Too Many Requests               | RFC 6585              |
| 431    | Request Header Fields Too Large | RFC 6585              |
| 451    | Unavailable For Legal Reasons   | RFC 7725              |
| 499    | Client Closed Request           | nginx, não registrado |

## Causas comuns

- A verificação aponta para uma URL que mudou de lugar, foi renomeada ou nunca esteve certa.
- A autenticação que a verificação envia expirou, foi rotacionada ou nunca foi configurada.
- O método, os cabeçalhos ou o corpo da requisição não batem com o que o endpoint espera.
- Um WAF, um filtro de bots ou um limitador de taxa está rejeitando especificamente o monitor, enquanto o tráfego real passa.
- O endpoint retorna um 4xx de propósito como parte do funcionamento normal, e a verificação trata isso como falha.

## Como diagnosticar

1. Leia o código exato, não só a classe. 401, 403, 404, 405 e 429 têm correções completamente diferentes.
2. Reproduza a requisição da verificação de outro lugar com curl, incluindo os cabeçalhos e o método.
3. Compare com uma requisição feita por um cliente real. A diferença quase sempre é a resposta.
4. Procure a requisição do monitor no log de acesso do servidor e veja o que ficou registrado.
5. Se a requisição funciona da sua máquina e não do monitor, desconfie de um filtro por IP ou por user-agent.

## De quem é a culpa? Normalmente, do lado do cliente

Por definição, o problema está na requisição. No monitoramento, isso quase sempre significa que é a verificação que precisa de correção, e não o serviço. As duas exceções que valem investigação do lado do servidor são 429 e 408.

## O que o monitoramento vê

Por padrão, uma verificação da Uptimely só passa quando o status da resposta está entre 200 e 399, então qualquer 4xx a faz falhar. O código exato é registrado com a verificação, de modo que a falha aparece como um 401 ou um 404, e não como um erro genérico. Se um endpoint responde com um 4xx de propósito, mude os critérios do monitor para verificar o código de status que você espera, em vez de deixá-lo alertar toda noite. Por padrão, um incidente só é declarado depois de duas verificações com falha seguidas. Um 408 não é diferente: ele é registrado como status 408 e faz a verificação falhar como qualquer outro status fora desse intervalo.

## Guias de erros relacionados

- [400 Bad Request](https://getuptimely.com/errors/400)
- [401 Unauthorized](https://getuptimely.com/errors/401)
- [403 Forbidden](https://getuptimely.com/errors/403)
- [404 Not Found](https://getuptimely.com/errors/404)
- [405 Method Not Allowed](https://getuptimely.com/errors/405)
- [408 Request Timeout](https://getuptimely.com/errors/408)
- [429 Too Many Requests](https://getuptimely.com/errors/429)
- [Erros 5xx de servidor](https://getuptimely.com/pt-BR/errors/5xx)

## Termos usados nesta página

- [Códigos de status HTTP](https://getuptimely.com/glossary/http-status-codes)
- [Falso positivo](https://getuptimely.com/glossary/false-positive)
- [Limite de falhas](https://getuptimely.com/glossary/failure-threshold)

## Perguntas

### Qual é a diferença entre um erro 4xx e um erro 5xx?

Um erro 4xx significa que o problema estava na requisição e o servidor a recusou, então a correção geralmente está no cliente ou na verificação. Um erro 5xx significa que a requisição era válida e o servidor não conseguiu atendê-la, então a correção está no servidor. Quem traça a linha é a classe, não o sintoma: um 408 Request Timeout é um 4xx porque o servidor esperava a requisição do cliente, enquanto um 504 Gateway Timeout é um 5xx porque um gateway esperava um servidor upstream.

### O 408 é um erro de servidor ou de cliente?

Um 408 Request Timeout é um erro de cliente, um 4xx, e não um erro 5xx de servidor. A RFC 9110 o define como o servidor não receber uma requisição completa dentro do tempo que estava disposto a esperar, então o status culpa a requisição que chegou devagar demais. A causa ainda pode estar no servidor ou na rede: um link lento, um cliente enviando um corpo grande ou um servidor com timeout de leitura curto. Um monitor o informa como status 408 e, por padrão, faz a verificação falhar, porque só passam as respostas de 200 a 399, a menos que você mude os critérios do monitor.

### Um monitor deve tratar todo 4xx como indisponibilidade?

Não. Um 4xx geralmente significa que a verificação está errada, não o serviço, e acionar alertas por isso ensina a equipe a ignorar alertas. As exceções são 429 e 408, que descrevem a capacidade do servidor e não a correção da requisição.

### Por que meu monitor recebe um 4xx e meu navegador não?

Quase sempre por uma diferença na requisição. Cookies ou cabeçalhos de autenticação ausentes, um user-agent diferente ou um filtro de bots que deixa um navegador passar e bloqueia um IP de data center. Reproduza a requisição exata do monitor com curl para ver qual é.

Um dos [guias de erros HTTP e de rede da Uptimely](https://getuptimely.com/errors), escritos para quem opera o servidor, e não para quem recarrega a página. Something here read wrong to you? Email **support@getuptimely.com**.

Verificado em 2026-11-15 pela equipe do Uptimely.
