Ошибка 502 Bad Gateway означает, что промежуточный сервер, чаще всего nginx, не получил нормальный ответ от backend. Пользователь видит белую страницу или стандартную ошибку, хотя домен и сервер формально доступны.
Чаще всего 502 появляется после падения PHP-FPM, перегрузки, ошибки в приложении, обновления конфигурации, проблем с Docker-контейнером или недоступности upstream-сервиса.
С чего начать диагностику
Для 502 важно смотреть не только сайт, но и связку: nginx, PHP-FPM, приложение, базу данных, контейнеры и ресурсы сервера.
- Проверить, стабильно ли возникает 502 или только периодически.
- Посмотреть error log nginx и лог backend-приложения.
- Проверить статус PHP-FPM, Docker-контейнеров или upstream-сервиса.
- Оценить нагрузку: CPU, память, диск, лимиты процессов.
- Проверить последние изменения конфигурации и деплоя.
Частые причины
- PHP-FPM не запущен или слушает другой сокет/порт
- backend завис или отвечает слишком долго
- nginx смотрит на неправильный upstream
- не хватает памяти или процессов
- контейнер приложения остановился
- ошибка после обновления PHP, CMS или зависимостей
Что можно проверить без риска
Снаружи можно понять масштаб проблемы, но настоящая причина почти всегда видна только в логах сервера.
- проверить сайт через несколько минут, чтобы понять, постоянная ли ошибка
- проверить другие страницы и поддомены
- посмотреть, не было ли обновлений или правок перед сбоем
- сохранить время возникновения ошибки для поиска в логах
- не запускать хаотично несколько перезапусков подряд
Когда лучше не экспериментировать
Бесконечные перезапуски nginx или PHP-FPM могут скрыть первопричину. Если ошибка вызвана нехваткой памяти, циклическим запросом или падением приложения, она вернется после временного восстановления.
Как я обычно чиню такую проблему
Я ищу источник разрыва между nginx и backend: где именно обрывается цепочка, какой сервис молчит и почему он перестал отвечать.
- Смотрю симптомы: адрес страницы, скриншот ошибки, время появления, что меняли перед сбоем.
- Проверяю серверные логи, конфигурацию сайта, права файлов, базу данных и зависимости.
- Делаю точечную правку: без лишней смены CMS, шаблона или случайной установки плагинов.
- Проверяю результат на основной странице, мобильной версии, формах и важных пользовательских сценариях.
- Кратко объясняю, что сломалось и что сделать, чтобы ошибка не повторялась.
Что подготовить для оценки
- адрес сайта или проблемной страницы
- когда появилась ошибка и что меняли перед этим
- доступ к хостингу, серверу или админке, если он нужен для проверки
- скриншот ошибки или текст из консоли, если он есть
- приоритет: срочно восстановить работу или спокойно разобраться в причине
Сроки
| Простой сбой PHP-FPM или upstream | 30-90 минут |
|---|---|
| Перегрузка или ошибка приложения | 2-4 часа |
| Docker, прокси, несколько сервисов | после диагностики |
Вопрос-ответ
502 — это ошибка хостинга?
Иногда да, но часто причина внутри сайта: backend, PHP-FPM, база, контейнер или неверная конфигурация.
Поможет ли просто перезагрузка сервера?
Может временно помочь, но без логов причина может повториться. Лучше понять, какой сервис упал и почему.
502 влияет на заявки?
Да. Если сайт или форма недоступны, пользователь не сможет отправить заявку, а рекламный трафик будет теряться.
Итог
Ошибка 502 — это проблема связи между фронтовым сервером и backend. Быстрое исправление возможно, но надежный результат дает только проверка логов, сервисов и ресурсов.
Если нужно быстро разобраться с такой ошибкой на сайте, напишите в Telegram: @rabotator_support. Посмотрю симптомы, скажу, что нужно проверить, и предложу аккуратный план исправления.