Ошибка 502 Bad Gateway: что значит и как исправить

Что означает ошибка 502 Bad Gateway

HTTP-код 502 отдаёт сервер-посредник (обратный прокси, например Nginx или балансировщик), когда он обратился к внутреннему серверу приложения (PHP-FPM, Node.js, Gunicorn и т.п.) и получил от него некорректный или пустой ответ. То есть «шлюз» работает, а вот приложение за ним — нет.

Для посетителя это значит, что сайт сейчас недоступен не из-за интернета или браузера, а из-за сбоя на сервере сайта.

Частые причины 502

• Упал или перезапускается backend (PHP-FPM, Node, приложение).
• Backend не успел ответить и прокси разорвал соединение.
• Неверная конфигурация upstream в Nginx (порт/сокет).
• Нехватка памяти/процессов — приложение убито OOM-killer.
• Сбой на стороне хостинга или CDN (например, Cloudflare → ваш сервер).

Как исправить 502 владельцу сайта

1. Откройте логи: error.log Nginx и лог приложения — там видно, что именно отвалилось.
2. Проверьте, запущен ли backend: systemctl status php-fpm (или node/gunicorn) и перезапустите его.
3. Сверьте upstream в конфиге Nginx: правильный порт/сокет, приложение слушает его.
4. Проверьте ресурсы: память и число воркеров; поднимите лимиты, если упирается.
5. Если стоит Cloudflare — временно отключите проксирование, чтобы понять, на чьей стороне сбой.

Что делать обычному посетителю

• Обновите страницу через минуту — часто это кратковременный сбой.
• Очистите кэш браузера или откройте сайт в режиме инкогнито.
• Проверьте сайт через сервис «доступности» — если лежит у всех, ждите, чинит владелец.

Как не ловить 502 в будущем

Настройте мониторинг доступности и оповещения, автоперезапуск сервисов (Restart=on-failure в systemd), держите запас по памяти и адекватные таймауты прокси. Если 502 повторяется регулярно — нужен технический аудит сервера и приложения.

Частые вопросы

Ошибка 502 — это у меня или у сайта?

Почти всегда на стороне сайта: его прокси-сервер получил плохой ответ от приложения. От посетителя обычно ничего не зависит, кроме как обновить страницу позже.

Чем 502 отличается от 504?

502 — backend вернул некорректный ответ, 504 — backend не ответил вовремя (таймаут). Это разные сбои связки «прокси ↔ приложение».

Как быстро починить 502?

Чаще всего помогает перезапуск backend (PHP-FPM/Node) и проверка логов Nginx и приложения на реальную причину.