Ошибка 502 Bad Gateway

Что это значит

Балансировщик (nginx, Cloudflare, ELB) получает запрос и передаёт его приложению. Если приложение не отвечает за отведённое время, обрывает соединение или отдаёт некорректный ответ — балансировщик возвращает 502. Для пользователя это выглядит как «сайт не работает», хотя веб-сервер отвечает.

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

• Упал PHP-FPM или app-сервер — самая частая причина после деплоя.
• Исчерпан пул воркеров — приложение живо, но не успевает обрабатывать запросы.
• Неверный upstream в конфиге — nginx смотрит в старый сокет или порт.
• Таймаут вышестоящего сервиса — запрос к базе или внешнему API висит дольше лимита.
• Переполнен диск или память — процесс не может писать логи или создавать сокеты.
• Блокировка WAF — защита отдаёт 502 вместо понятной ошибки.

Диагностика за 15 минут

1. Проверьте код ответа с внешних точек: если 502 только с одной — проблема в конкретном сервере.
2. Откройте /var/log/nginx/error.log — там будет upstream timed out, connect() failed или no live upstreams.
3. Проверьте, что бэкенд запущен: systemctl status php8.2-fpm, curl на локальный порт.
4. Сопоставьте время начала ошибки с деплоем, изменением конфига и нагрузкой.
5. Проверьте ресурсы: диск, память, лимиты файловых дескрипторов.

Если 502 совпал с релизом — не ищите причину в конфиге. Сначала откатите версию: это быстрее и безопаснее, чем диагностика под нагрузкой.

Как исправить

Как не допустить повторения

• Включите мониторинг доступности с проверкой каждую минуту и подтверждением с трёх точек.
• Настройте алерт на деградацию: рост p95 и доли 5xx предупреждает о проблеме раньше, чем 502.
• Добавьте проверку после деплоя: сценарий «открыть главную → корзина → оплата».
• Держите health-check эндпоинт, который проверяет зависимости, а не просто отдаёт 200.

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