<!-- Guias de erros HTTP e de rede — Uptimely -->
> Markdown version of https://getuptimely.com/pt-BR/errors — the page itself is the canonical copy.

Guias de erros

# Erros HTTP e de rede, do lado do servidor

A maioria das páginas sobre “502 Bad Gateway” manda o leitor limpar o cache e tentar de novo mais tarde, um conselho inútil para a única pessoa que pode de fato resolver. Estes guias foram escritos para quem opera o servidor: o que o código diz sobre a sua stack, as causas que vale verificar em ordem, como saber de que lado está o problema e o que uma verificação de uptime vai ver e o que não vai.

Para o vocabulário em vez dos códigos, o [glossário de monitoramento](https://getuptimely.com/glossary) define os termos que estes guias usam. Para falhas de TLS e de certificado como 525 e 526, [o monitoramento de certificados SSL](https://getuptimely.com/pt-BR/features/ssl-certificate-monitoring) mostra o que um monitor de certificado da Uptimely lê e quais regras alertam sobre ele. Para os erros legíveis por máquina que a própria API da Uptimely retorna, veja a [documentação da API](https://getuptimely.com/docs/api).

## Erros de cliente (4xx)

A culpa foi da requisição. Numa verificação de monitoramento, isso quase sempre significa que é a verificação que precisa de conserto, e não o serviço, com duas exceções.

### [Erros 4xx de cliente](https://getuptimely.com/pt-BR/errors/4xx)

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.

### [400 Bad Request](https://getuptimely.com/errors/400)

O servidor não conseguiu interpretar ou não quis aceitar a requisição como foi enviada: ela estava malformada antes de qualquer lógica rodar.

### [401 Unauthorized](https://getuptimely.com/errors/401)

A requisição precisa de autenticação e não enviou credenciais válidas: o servidor não sabe quem você é.

### [403 Forbidden](https://getuptimely.com/errors/403)

O servidor entendeu a requisição e se recusa a atendê-la: autenticar não vai mudar a resposta.

### [404 Not Found](https://getuptimely.com/errors/404)

O servidor não tem nada nesse caminho, e não vai dizer se nunca teve ou se não tem mais.

### [405 Method Not Allowed](https://getuptimely.com/errors/405)

Um erro 405 Method Not Allowed significa que a URL existe, mas não aceita o método HTTP usado, normalmente um GET enviado a um endpoint feito para POST.

### [408 Request Timeout](https://getuptimely.com/errors/408)

O servidor desistiu de esperar que o cliente terminasse de enviar a requisição.

### [410 Gone](https://getuptimely.com/errors/410)

O recurso existiu e foi removido de forma permanente: uma versão deliberada e definitiva do 404.

### [429 Too Many Requests](https://getuptimely.com/pt-BR/errors/429)

O cliente atingiu um limite de taxa: o servidor está descartando as requisições dele de propósito para se proteger.

### [499 Client Closed Request](https://getuptimely.com/errors/499)

O código próprio do Nginx para um cliente que desligou antes de a resposta ficar pronta: um sintoma de lentidão, não uma causa.

## Erros de servidor (5xx)

A falha é do seu lado. O código específico identifica a camada, e isso é a maior parte da triagem.

### [Erros 5xx de servidor](https://getuptimely.com/pt-BR/errors/5xx)

A classe que significa que o servidor não conseguiu atender uma requisição que, até onde ele podia dizer, era válida.

### [500 Internal Server Error](https://getuptimely.com/errors/500)

A aplicação sofreu uma falha não tratada: a resposta genérica quando nada mais específico se aplica.

### [501 Not Implemented](https://getuptimely.com/errors/501)

O servidor não oferece de forma alguma a funcionalidade necessária para atender a requisição.

### [502 Bad Gateway](https://getuptimely.com/errors/502)

Um proxy pediu uma resposta à sua aplicação e recebeu algo que não conseguia usar, ou nada.

### [503 Service Unavailable](https://getuptimely.com/errors/503)

O servidor está se recusando de propósito a atender agora: sobrecarregado, em manutenção ou sem nada saudável para onde rotear.

### [504 Gateway Timeout](https://getuptimely.com/errors/504)

Um proxy esperou pela sua aplicação e desistiu: o upstream estava acessível, só lento demais.

### [508 Loop Detected](https://getuptimely.com/errors/508)

O servidor abortou uma requisição porque ela estava andando em círculos: normalmente um loop de redirecionamento ou de reescrita.

## Erros de origem da Cloudflare (52x)

Códigos próprios da Cloudflare, não padrões HTTP. Cada um diz algo específico sobre o trecho entre a borda e a sua origem.

### [Cloudflare 520 Web Server Returns an Unknown Error](https://getuptimely.com/errors/520)

A Cloudflare chegou à sua origem e recebeu uma resposta que não conseguia usar: vazia, malformada ou cortada.

### [Cloudflare 521 Web Server Is Down](https://getuptimely.com/errors/521)

A Cloudflare chegou à sua origem e a origem recusou a conexão de cara.

### [Cloudflare 522 Connection Timed Out](https://getuptimely.com/errors/522)

A Cloudflare tentou se conectar à sua origem e não recebeu resposta nenhuma antes de desistir.

### [Cloudflare 523 Origin Is Unreachable](https://getuptimely.com/errors/523)

A Cloudflare não conseguiu rotear até a sua origem de forma alguma: normalmente um registro DNS que não aponta para nada.

### [Cloudflare 524 A Timeout Occurred](https://getuptimely.com/errors/524)

A Cloudflare se conectou à sua origem e enviou a requisição, e a origem levou mais de 125 segundos para responder.

### [Cloudflare 525 SSL Handshake Failed](https://getuptimely.com/errors/525)

A Cloudflare chegou à sua origem, mas não conseguiu concluir o handshake TLS com ela.

### [Cloudflare 526 Invalid SSL Certificate](https://getuptimely.com/errors/526)

A Cloudflare chegou à sua origem por HTTPS e rejeitou o certificado que ela apresentou.

## Falhas de rede e de TLS

Falhas sem nenhum código de status, porque a requisição nunca foi longe o bastante para existir uma resposta. É o que um monitor informa quando nada respondeu.

### [NXDOMAIN (DNS name not found)](https://getuptimely.com/errors/dns-nxdomain)

O resolvedor DNS respondeu de forma definitiva que o nome não existe, antes de qualquer tentativa de conexão.

### [Connection refused (ECONNREFUSED)](https://getuptimely.com/errors/connection-refused)

O host respondeu à tentativa de conexão com uma recusa explícita: nada está escutando nessa porta.

### [Connection timeout (ETIMEDOUT)](https://getuptimely.com/errors/connection-timeout)

A tentativa de conexão não recebeu resposta nenhuma e o cliente acabou desistindo.

### [Certificado SSL vencido](https://getuptimely.com/pt-BR/errors/ssl-certificate-expired)

O período de validade do certificado terminou, então todos os clientes recusam a conexão.

### [SSL/TLS handshake failed](https://getuptimely.com/errors/ssl-handshake-failed)

Um “SSL handshake failed” ou uma falha no handshake TLS significa que a conexão TCP deu certo e que a negociação TLS por cima dela não deu.

### [Connection reset by peer (ECONNRESET)](https://getuptimely.com/errors/econnreset)

Uma conexão já estabelecida foi encerrada de repente pela outra ponta, no meio da troca.

A code you were looking for and did not find? Email **support@getuptimely.com**. Para saber quando um destes começar a acontecer no seu próprio serviço: [Uptimely checks every minute on the free plan](https://getuptimely.com/pricing).

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