-
Сбой
Время, адрес и затронутые функции
-
Журнал
Сообщение Nginx и приложения
-
Причина
Процесс, подключение или ресурсы
-
Приёмка
Страницы, заказ и наблюдение
Ошибка 502 Bad Gateway означает, что сервер-посредник не получил корректный ответ от следующего обработчика. На сайте с Nginx это может быть PHP-FPM или другое приложение. Начните со времени ошибки и журнала Nginx: одинаковая страница 502 появляется при разных неисправностях, поэтому увеличение таймаута наугад часто не помогает.
Определите, какой узел вернул ошибку
Откройте проблемный адрес и запишите время с часовым поясом, URL, статус и действие пользователя. Уточните, затронут весь сайт, только корзина или отдельный запрос. Если перед сервером есть CDN, проверьте его события и ответ исходного сервера через разрешённую диагностику. Не отключайте защиту сайта для общего доступа ради эксперимента.
Владельцу сайта на обычном хостинге достаточно передать эти данные поддержке. На VPS администратор дополнительно смотрит журналы веб-сервера и обработчика. Доступ к логам ограничьте: в них могут быть адреса, токены и данные запросов.
| Сообщение | Что проверять | Что ещё не установлено |
|---|---|---|
| Connection refused | Запущено ли приложение, совпадают ли адрес и порт upstream | Причина остановки процесса |
| No such file or directory | Путь к Unix-сокету и конфигурацию запущенного пула | Нужно ли менять PHP или только адрес подключения |
| Permission denied | Права на сокет и доступ пользователя веб-сервера | Не требуется ли исправить владельца вместо расширения прав всем |
| Upstream prematurely closed connection | Журнал приложения, падение процесса, ограничения памяти | Ошибка кода или принудительное завершение системой |
| Invalid header | Что вернул upstream и как настроен протокол подключения | Корректность ответа приложения |
Адрес обработчика задаётся по-разному: fastcgi_pass используется для FastCGI, а proxy_pass — для HTTP upstream. Подмена одной директивы другой без проверки приложения создаёт новую ошибку.
Проверьте процесс и его ресурсы
Посмотрите состояние нужного пула PHP-FPM или службы приложения. Имя службы зависит от установленной версии и системы. Сопоставьте время 502 с перезапуском, сообщением об исчерпании памяти, лимитом рабочих процессов и заполнением диска. Показатель свободной памяти после события может уже выглядеть нормальным: важен журнал в момент сбоя.
Если сервис не запускается, сохраните текст ошибки конфигурации. Если работает, но периодически перестаёт отвечать, проверьте очередь запросов и длительные операции. Увеличение числа процессов без расчёта потребления памяти способно усилить проблему.
Учебный случай: изменился путь к сокету
После обновления PHP в конфигурации Nginx остался адрес старого сокета. Новый пул запущен, но слушает другой путь. Веб-сервер не может подключиться и показывает 502.
- Администратор находит запись об отсутствующем сокете за время проверки.
- Сопоставляет адрес fastcgi_pass с параметром listen работающего пула.
- Исправляет подключение для нужного сайта и проверяет конфигурацию.
- После согласованного применения открывает карточку, корзину и личный кабинет, затем следит за повторными ошибками.
При падении приложения или нехватке памяти исправления сокета недостаточно: найдите причину остановки процесса по журналам приложения и системы.
Отделите 502 от соседних ошибок
При 500 приложение или сервер сообщает о внутренней ошибке. При 504 посредник не дождался ответа в отведённое время. Код 503 обычно означает недоступность обслуживания. Собственная страница CDN может скрывать исходный код, поэтому сохраняйте цепочку ответов и журналы. Для ошибки 503 нужен отдельный разбор.
Не повышайте все таймауты одновременно. Долгий отчёт, перегруженный обработчик и неверный адрес требуют разных исправлений. Повторная отправка POST-запроса также опасна: заказ или оплата могли уже выполниться, хотя браузер получил ошибку.
Что передать специалисту и как принять исправление
- Время, URL, снимок ошибки и последовательность действий.
- Недавние обновления PHP, CMS, модулей, конфигурации и тарифа хостинга.
- События Nginx, приложения и системы за один интервал.
- Перечень затронутых функций и сведения о резервной копии.
Приёмка включает повтор исходного сценария, проверку журналов и наблюдение в обычный период нагрузки. Одна успешно открытая главная не проверяет создание заказа. Для магазина используйте сценарий проверки корзины.
Частые вопросы
Поможет перезагрузка сервера?
Она может временно восстановить процесс, но не объяснит причину. До перезапуска сохраните доступные журналы и показатели; после него проверьте, не повторяется ли событие.
502 появляется только у одного посетителя. Это ошибка сервера?
Нужно сравнить время и запросы: возможны разные узлы CDN, особый маршрут, состояние сессии или конкретная операция. Начните с воспроизводимого примера, а не с изменения настроек для всех.
При повторяющихся сбоях можно заказать проверку хостинга и серверного окружения. Передайте симптомы и время события; доступы согласуем отдельно.
