Ответ 502 Bad Gateway — самая частая поломка сайта за прокси, и почти каждый DevOps-инженер видел её в первую же неделю работы. Её отдаёт nginx — веб-сервер и прокси из раздела 05, — когда сам он работает, а приложение за ним ответить не смогло. Коды 504 и 500 выглядят похоже, но ведут в разные места, и путать их значит потерять полчаса.
Адрес, куда nginx передаёт запросы, называют upstream — «выше по течению»: у нас это контейнер приложения, описанный в блоке upstream app_backend. Чтобы найти поломку, нужны два источника. Код ответа говорит, что именно случилось с upstream, а лог ошибок nginx — где и почему. В уроке разберёшь оба, четыре частые строки из лога и ловушку, при которой 502 идёт, хотя приложение живо.
Три кода
Все три кода значат «плохо», но плохо в разных местах. По ним сразу понятно, куда смотреть.
| Код | Кто виноват | Что случилось |
|---|---|---|
| 502 Bad Gateway | связь прокси с приложением | соединиться не удалось или ответ битый |
| 504 Gateway Timeout | приложение медленное | принял запрос и молчал дольше таймаута |
| 503 Service Unavailable | приложение или то, от чего оно зависит | живо, но честно говорит «сейчас не могу» |
| 500 Internal Server Error | само приложение | ответило, но упало внутри |
Возьмём вторую строку. 504 приходит ровно через proxy_read_timeout — сколько nginx ждёт ответа от приложения. В нашем stand.conf эта настройка не задана, значит, действует значение по умолчанию — 60 секунд. Если ответ 504 приходит всегда через одно и то же время, это верный признак: приложение живо, но что-то держит его — чаще всего медленный запрос к базе.
503 на стенде отдаёт само приложение: адрес /items так отвечает, когда не может подключиться к базе. Строки Server: nginx тут мало — nginx лишь передал ответ, а тело ответа, {"error":"database unavailable"}, написано приложением.
А 500 отдаёт уже приложение, не прокси. С ним идут сразу в логи приложения: nginx тут ни при чём, он просто передал ответ.
Где nginx пишет причину
У nginx два лога. Журнал доступа (access log) пишет строку на каждый запрос: время, адрес, код. Лог ошибок (error log) — подробности, когда что-то пошло не так. В журнале доступа ты увидишь только «502», а причину nginx кладёт во второй.
Для пакетного nginx лог ошибок лежит в /var/log/nginx/error.log. Флаг -n 5 у tail печатает пять последних строк:
sudo tail -n 5 /var/log/nginx/error.log 2026/10/01 11:31:07 [error] 29#29: *812 connect() failed (111: Connection refused) while connecting to upstream, client: 10.0.0.7, server: stand.provision.internal, request: "GET /api/items HTTP/1.1", upstream: "http://172.20.0.4:8000/items"
Строка длинная, но читается по частям: время, уровень [error], сама причина — Connection refused, — и в конце upstream: куда nginx пытался пойти. Здесь видно и адрес, и порт: 172.20.0.4:8000.
Если nginx работает в контейнере, как на стенде, лог ошибок уходит в поток вывода, и смотрят его через docker compose logs proxy. Это мы настроили в миссии раздела про Compose.
Четыре частые строки
Причин 502 немного, и каждая узнаётся по своей строке в логе ошибок.
Первая строка — самая частая. Проверка одной командой: docker compose ps покажет, работает ли контейнер приложения, а если работает — запрос из контейнера прокси покажет, слушает ли оно тот порт. curl в образе приложения нет, поэтому спрашиваем маленьким wget, который есть в образе nginx: docker compose exec proxy wget -qO- app:8000/health.
Последняя строка часто означает, что процесс приложения убило ядро из-за нехватки памяти. Это отдельный маршрут, разберём его в уроке про диск, память и процессор.
Ловушка: запомненный адрес
Есть поломка, которая сбивает с толку почти всех, кто держит nginx в контейнере. Приложение пересоздали, оно работает и отвечает изнутри — а nginx продолжает отдавать 502.
Причина в том, как nginx читает блок upstream. Имя app он превращает в адрес один раз, при своём запуске, и дальше ходит по запомненному адресу. Пересозданный контейнер получил от Docker новый адрес, а nginx стучится в старый, где никого нет.
Лечится просто — заставить nginx перечитать настройки. Флаг -s reload посылает ему сигнал «перечитай», не обрывая текущие соединения:
docker compose exec proxy nginx -s reload 2026/10/01 11:40:02 [notice] 41#41: signal process started
Строка signal process started значит, что сигнал доставлен. Навсегда эту ловушку закрывают две настройки. Директива resolver 127.0.0.11 valid=10s; говорит nginx, у кого спрашивать адреса: 127.0.0.11 — встроенный DNS Docker внутри каждого контейнера, valid=10s — помнить ответ десять секунд. А пометка resolve у строки server app:8000 в блоке upstream (вместе со строкой zone, общей памятью для адресов) велит переспрашивать адрес, а не помнить его с запуска. В бесплатном nginx это появилось в версии 1.27.3, подробности — в документации. На стенде мы так не делаем; здесь достаточно узнавать ловушку и знать, чем её закрывают.
Маршрут целиком
Сложим всё в маршрут, по которому идут при ответе 502.
Пять шагов, по одной команде на каждый. Обычно ответ находится на втором: строка в логе ошибок почти всегда называет причину прямо.
Словарь урока
Что спросят на собеседовании
- Пользователи видят 502. Как будешь искать причину?Посмотрю лог ошибок nginx: какой upstream и какая ошибка. Дальше проверю, жив ли контейнер приложения и слушает ли он нужный порт.
- Чем 502 отличается от 504?502 — не удалось соединиться или ответ битый. 504 — приложение не ответило за время proxy_read_timeout, обычно оно занято медленной операцией.
- Почему после пересоздания контейнера nginx может отдавать 502?Он превратил имя upstream в адрес при старте и помнит старый. Нужно перечитать настройки или настроить resolver.
Что дальше
В практике сломаем стенд двумя способами — остановим приложение и укажем не тот порт — и найдём обе поломки по логу ошибок.