Что означает 502 Bad Gateway
Ошибка 502 Bad Gateway появляется, когда промежуточный сервер не получил корректный ответ от следующего узла. Чаще всего пользователь видит ее на сайтах, где перед приложением стоит nginx, Apache, CDN, балансировщик или прокси. Сам веб-сервер отвечает, но приложение за ним не смогло нормально обработать запрос.
Для владельца сайта это важный сигнал: домен может открываться, соединение с сервером есть, но пользователь все равно не получает рабочую страницу. Поэтому ошибка 502 относится к реальным инцидентам доступности, даже если сервер не выключен полностью.
Почему возникает 502
Причины бывают разными. Приложение могло упасть после релиза, PHP-FPM или другой backend-процесс мог перестать отвечать, база данных могла зависнуть, а прокси мог не дождаться ответа за отведенное время. Иногда 502 появляется из-за неправильной настройки upstream: адрес приложения изменили, а конфиг nginx не обновили.
Отдельный случай - перегрузка. Если сайт получил больше запросов, чем способен обработать, очередь растет, backend отвечает медленнее, а прокси начинает возвращать 502 или 504. Для интернет-магазина это особенно неприятно: посетитель уже пришел за покупкой, но вместо каталога видит техническую ошибку.
Как отличить 502 от других ошибок
Ошибка 500 обычно говорит о проблеме внутри приложения. Ошибка 503 часто означает временную недоступность сервиса или режим обслуживания. 504 указывает на таймаут ожидания ответа. 502 находится между ними: прокси жив, но ответ от backend получился некорректным или не пришел в ожидаемом виде.
Для диагностики важно смотреть не только текст на странице. Нужно проверить код ответа, время события, логи веб-сервера, логи приложения и нагрузку. Если ошибка повторяется короткими всплесками, ручная проверка может ее не поймать.
Что сделать сразу
Проверьте, идет ли ошибка на всех страницах или только в отдельном разделе. Если не работает только оформление заказа, проблема может быть в конкретной интеграции. Если не открывается весь сайт, проверьте backend-процессы, базу данных, свободное место на диске и последние изменения конфигурации.
После восстановления важно понять длительность простоя. Для этого нужна история проверок. Если мониторинг фиксировал падение каждые несколько минут, можно увидеть, был ли это единичный сбой или серия повторяющихся проблем.
Как помогает Web-Puls
Web-Puls может регулярно проверять сайт и фиксировать момент, когда вместо рабочей страницы приходит ошибка. В кабинете видны события падения и восстановления, а уведомление по email приходит бесплатно. Это позволяет реагировать не по случайной жалобе клиента, а по факту проверки.
Для 502 полезно добавить не только проверку HTTP-кода, но и текстовые правила. Например, если сайт иногда отдает страницу nginx с текстом `Bad Gateway`, такое сообщение можно считать признаком аварии. Так мониторинг поймает ситуацию, когда сервер технически отвечает, но пользователь видит ошибку.
Когда нужна помощь специалиста
Если 502 возвращается регулярно, проблему нужно искать в связке веб-сервер, приложение, база данных, очереди, кеш и ресурсы сервера. Владелец сайта может быстро проверить факт сбоя, но для устранения причины часто нужны логи и доступ к инфраструктуре.
В такой ситуации можно отправить заявку на платную профессиональную поддержку через `/support/`. В описании стоит указать сайт, примерное время ошибки, что менялось перед сбоем и есть ли доступ к логам. Это ускорит оценку задачи и поможет быстрее перейти от симптома к причине.
Вывод
502 Bad Gateway - это не "мелкая техническая страница", а сигнал, что пользователь не получил рабочий сайт. Лучший подход - заранее настроить мониторинг, получать уведомления о сбоях и сохранять историю. Тогда повторяющиеся 502 можно обсуждать предметно: когда возникали, сколько длились и какая часть сайта была затронута.