Como diagnosticar erros 502 e 504 no Nginx?

Question

IT Interview Practice · Accepted Answer

Descubra onde a requisição falhou antes de aumentar timeouts. Um 502 frequentemente indica falha de comunicação com o upstream; um 504 frequentemente indica que a espera pelo upstream expirou. Os logs distinguem a falha real.

## Exemplo: a aplicação não está escutando

Suponha que um trecho do log de erros diga:

```text
connect() failed (111: Connection refused) while connecting to upstream
upstream: "http://127.0.0.1:3000/products"
```

O Nginx tentou conectar à porta 3000 e foi recusado. Verifique se a aplicação está rodando e escutando nesse endereço. Na própria máquina ou contêiner do Nginx, teste `curl -i http://127.0.0.1:3000/products`. Dentro de um contêiner, esse endereço se refere ao próprio contêiner, não automaticamente ao contêiner de outra aplicação.

## Exemplo: conectou, mas os cabeçalhos não chegaram a tempo

```text
upstream timed out while reading response header from upstream
```

Isso aponta para espera pelos cabeçalhos de resposta. Correlacione a requisição com logs da aplicação e consultas lentas ao banco. Verifique o tempo de conexão e o tempo de resposta upstream para separar a configuração da rede do trabalho da aplicação.

## Confirme a correção

No primeiro caso, corrija o endereço ou restaure a aplicação com falha; no segundo, investigue o trabalho lento. Tente novamente a rota afetada e monitore taxa de erros e latência. Um `proxy_read_timeout` maior permite um intervalo maior entre leituras; não cria capacidade no backend. Consulte também logs do CDN e da aplicação se algum deles gerou o erro.

[Documentação oficial](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_read_timeout).

Exemplo: a aplicação não está escutando

Exemplo: conectou, mas os cabeçalhos não chegaram a tempo

Confirme a correção

Perguntas relacionadas