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

Guia de erros

# Erros 5xx de servidor

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

Um status 5xx significa que o servidor não conseguiu atender uma requisição que parecia válida. A responsabilidade está do lado do servidor: a aplicação, suas dependências ou a infraestrutura na frente dela. Ao contrário de um 4xx, nenhuma mudança que o cliente pudesse fazer o teria evitado.

Esta é a classe para a qual o monitoramento existe, e todo código dela deve fazer uma verificação falhar por padrão. É também a classe mais visível para os clientes, porque um 5xx geralmente significa que uma requisição que deveria ter funcionado não funcionou.

O código específico mostra qual camada falhou, e isso é a maior parte da triagem inicial: 500 é a aplicação lançando uma exceção; 502 e 504 são um proxy informando que algo atrás dele falhou ou foi lento demais; 503 é uma recusa deliberada por capacidade ou manutenção; 501 é um método que o servidor não implementa. Chegar rápido à camada certa vale mais do que qualquer quantidade de palpites sobre as causas.

__Lista de códigos de erro 5xx: os erros de servidor registrados, mais o 509 e os códigos 52x da Cloudflare__
| Código | Nome                                | Definido em                                                                                           |
| ------ | ----------------------------------- | ----------------------------------------------------------------------------------------------------- |
| 500    | Internal Server Error               | RFC 9110                                                                                              |
| 501    | Not Implemented                     | RFC 9110                                                                                              |
| 502    | Bad Gateway                         | RFC 9110                                                                                              |
| 503    | Service Unavailable                 | RFC 9110                                                                                              |
| 504    | Gateway Timeout                     | RFC 9110                                                                                              |
| 505    | HTTP Version Not Supported          | RFC 9110                                                                                              |
| 506    | Variant Also Negotiates             | RFC 2295                                                                                              |
| 507    | Insufficient Storage                | RFC 4918 (WebDAV)                                                                                     |
| 508    | Loop Detected                       | RFC 5842 (WebDAV)                                                                                     |
| 509    | Bandwidth Limit Exceeded            | Não registrado: enviado por alguns provedores de hospedagem quando uma conta esgota sua cota de banda |
| 510    | Not Extended                        | RFC 2774, hoje obsoleta                                                                               |
| 511    | Network Authentication Required     | RFC 6585                                                                                              |
| 520    | Web Server Returns an Unknown Error | Cloudflare, não registrado                                                                            |
| 521    | Web Server Is Down                  | Cloudflare, não registrado                                                                            |
| 522    | Connection Timed Out                | Cloudflare, não registrado                                                                            |
| 523    | Origin Is Unreachable               | Cloudflare, não registrado                                                                            |
| 524    | A Timeout Occurred                  | Cloudflare, não registrado                                                                            |
| 525    | SSL Handshake Failed                | Cloudflare, não registrado                                                                            |
| 526    | Invalid SSL Certificate             | Cloudflare, não registrado                                                                            |

## Causas comuns

- Uma exceção não tratada no código da aplicação.
- Uma dependência (banco de dados, cache, fila, API de terceiros) falhando ou estourando o tempo.
- Esgotamento de recursos: memória, descritores de arquivo, pools de conexão, disco.
- Um deploy que entregou um bug, ou uma mudança de configuração que quebrou uma conexão.
- Um serviço upstream fora do ar, inacessível ou respondendo devagar demais.

## Como diagnosticar

1. Leia primeiro o código exato: ele identifica a camada, e a camada determina onde procurar.
2. Veja se o erro está no log da sua aplicação ou só no do proxy: só isso já divide a busca pela metade.
3. Descubra se ele afeta todas as requisições ou só uma parte, o que distingue uma falha total de uma parcial.
4. Cruze o horário de início com deploys, mudanças de configuração e incidentes de dependências.
5. Verifique a saúde de cada dependência antes de depurar o seu próprio código; a maioria dos incidentes 5xx é a queda de outra pessoa chegando até você.

## De quem é a culpa? Do lado do servidor

Por definição, do lado do servidor, embora um 5xx muitas vezes seja causado por uma dependência e não pela própria aplicação, e continua sendo o seu incidente mesmo quando o bug não é seu.

## O que o monitoramento vê

Os critérios padrão da Uptimely fazem uma verificação falhar diante de um 5xx e registram o código exato. Um monitor declara um incidente quando o limite de falhas é atingido (duas verificações com falha seguidas, por padrão), então uma falha isolada é registrada como indisponibilidade sem acionar ninguém, enquanto um 5xx persistente abre um incidente e executa a política de plantão.

## Guias de erros relacionados

- [500 Internal Server Error](https://getuptimely.com/errors/500)
- [502 Bad Gateway](https://getuptimely.com/errors/502)
- [503 Service Unavailable](https://getuptimely.com/errors/503)
- [504 Gateway Timeout](https://getuptimely.com/errors/504)
- [501 Not Implemented](https://getuptimely.com/errors/501)
- [508 Loop Detected](https://getuptimely.com/errors/508)
- [Erros 4xx de cliente](https://getuptimely.com/pt-BR/errors/4xx)

## Termos usados nesta página

- [Incidente](https://getuptimely.com/glossary/incident)
- [Limite de falhas](https://getuptimely.com/glossary/failure-threshold)
- [Códigos de status HTTP](https://getuptimely.com/glossary/http-status-codes)
- [Alerta](https://getuptimely.com/glossary/alert)

## Perguntas

### Todo 5xx deve disparar um alerta?

Todo 5xx deve fazer a verificação falhar. Se ele alerta depende do limite: esperar duas falhas seguidas elimina as falhas isoladas sem deixar de registrá-las como indisponibilidade, o que quase sempre é o padrão certo.

### Quais códigos 5xx apontam para um proxy e não para a minha aplicação?

502 e 504 são gerados por algo na frente da sua aplicação: um proxy reverso ou uma CDN informando que o upstream falhou ou foi lento demais. Um 500 vem da própria aplicação.

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.
