Когда сервер выдает 502 Bad Gateway, веб-сервер жив, но не может получить корректный ответ от приложения или обработчика.

Для пользователя это полный отказ страницы. Для владельца важно понять, что не отвечает: PHP-FPM, Node.js, Docker-контейнер, socket или upstream.

Коротко: нужно проверить логи Nginx, состояние backend-сервиса, socket или порт, права и последние изменения.

Почему это ломается

502 появляется из-за остановленного PHP-FPM, неверного socket, недоступного upstream, падения Node.js, рестарта контейнера, прав на socket, таймаутов или конфигурации Nginx, которая смотрит не туда.

Что проверяю первым

  • что пишет Nginx error_log
  • запущен ли backend-сервис
  • существует ли PHP-FPM socket
  • отвечает ли приложение на локальном порту
  • не менялся ли конфиг перед ошибкой

Как проходит исправление

Я проверяю цепочку от Nginx до backend: конфиг, upstream, сервис, socket или порт, затем тестирую внешний URL.

  • запускаю или чиню PHP-FPM/backend
  • исправляю socket или port в Nginx
  • проверяю права на socket
  • чиню upstream и proxy_pass
  • добавляю контроль автозапуска сервисов

Что подготовить

  • домен с 502
  • логи Nginx
  • тип backend: PHP, Node.js, Docker
  • доступ к серверу
  • что менялось перед ошибкой

Какой результат нужен

Сайт должен открываться без 502, а backend-сервис должен стабильно отвечать и подниматься после перезагрузки.

Чего лучше не делать

Не ограничивайтесь перезапуском Nginx. Если backend падает, 502 вернется снова.

Вопросы и ответы

Почему 502 появляется иногда?

Backend может падать под нагрузкой, перезапускаться или упираться в лимиты.

Что важнее смотреть первым?

Nginx error_log: там обычно видно, к какому upstream он не смог подключиться.

Может ли виноват PHP-FPM?

Да, это одна из частых причин 502 на PHP-сайтах.

Нужно ли увеличивать таймауты?

Только если backend реально долго отвечает. Сначала нужно понять, почему он не отвечает.

Нужна похожая задача?

Напишите в Telegram @rabotator_support или оставьте заявку на сайте. Коротко опишите проблему, приложите ссылку, скриншот или лог ошибки, и я подскажу, с чего безопасно начать исправление.

Итог

502 Bad Gateway почти всегда находится между прокси и backend. Логи Nginx и состояние приложения дают самый короткий путь к исправлению.