Как диагностировать ошибки 502 и 504 в Nginx?

Question

IT Interview Practice · Accepted Answer

Определите место сбоя запроса до увеличения тайм-аутов. 502 часто указывает на сбой связи с upstream, а 504 — на истечение ожидания upstream. Реальную причину различают журналы.

## Пример: приложение не слушает порт

Предположим, в журнале ошибок есть:

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

Nginx попытался подключиться к порту 3000 и получил отказ. Проверьте, работает ли приложение и слушает ли этот адрес. С машины или контейнера самого Nginx выполните `curl -i http://127.0.0.1:3000/products`. В контейнере этот адрес относится к нему самому, а не автоматически к контейнеру другого приложения.

## Пример: подключение есть, но заголовки не пришли вовремя

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

Это указывает на ожидание заголовков ответа. Сопоставьте запрос с журналами приложения и медленными запросами базы. Проверьте время соединения и ответа upstream, чтобы отделить установление сети от работы приложения.

## Подтвердите исправление

В первом случае исправьте адрес или восстановите приложение; во втором исследуйте медленную работу. Повторите затронутый маршрут и наблюдайте частоту ошибок и задержку. Увеличенный `proxy_read_timeout` допускает больший интервал между чтениями, но не создаёт мощности бэкенда. Проверяйте также журналы CDN и приложения, если ошибку создал кто-то из них.

[Официальная документация](https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_read_timeout).

Пример: приложение не слушает порт

Пример: подключение есть, но заголовки не пришли вовремя

Подтвердите исправление

Похожие вопросы