К содержимому

Ошибка 502 Bad Gateway в связке nginx и php-fpm

502 Bad Gateway означает, что nginx принял запрос, но не смог получить ответ от php-fpm: процесс не запущен, сокет недоступен или пул упал при обработке. Сначала проверьте статус службы php8.3-fpm и путь к сокету в конфиге nginx, затем смотрите логи пула.

Ошибка PHP 3 мин чтения

01Служба php8.3-fpm не запущена или упала

Самая частая причина: процесс php-fpm остановлен, перезапускается после падения или не стартовал после установки. Проверьте статус командой systemctl status php8.3-fpm. Если в выводе inactive (dead) или failed, запустите службу и посмотрите журнал journalctl -u php8.3-fpm -n 50.

bash
sudo systemctl status php8.3-fpm
sudo systemctl start php8.3-fpm
sudo journalctl -u php8.3-fpm -n 50 --no-pager

02Неверный путь к сокету в конфиге nginx

nginx передаёт запрос в php-fpm через Unix-сокет, и путь в fastcgi_pass должен совпадать с listen в пуле. Откройте файл пула /etc/php/8.3/fpm/pool.d/www.conf и найдите строку listen =. Затем сверьте её со значением fastcgi_pass в конфиге сайта. Для стандартного пула это unix:/run/php/php8.3-fpm.sock.

bash
grep -n "^listen" /etc/php/8.3/fpm/pool.d/www.conf
grep -rn "fastcgi_pass" /etc/nginx/sites-enabled/

03Права доступа к сокету

Если путь верный, но nginx получает Permission denied в своём error.log, сокет принадлежит другому пользователю или группе. В www.conf параметры listen.owner, listen.group и listen.mode задают владельца сокета. Для nginx обычно указывают пользователя www-data и режим 0660.

ini
listen.owner = www-data
listen.group = www-data
listen.mode = 0660

04Пул php-fpm исчерпал лимит процессов

Когда все дочерние процессы заняты, новые соединения остаются в очереди и nginx отдаёт 502 по таймауту. В логе пула появляются строки server reached pm.max_children setting. Увеличьте pm.max_children в www.conf с запасом по памяти и перезагрузите службу.

ini
pm = dynamic
pm.max_children = 20
pm.start_servers = 5
pm.min_spare_servers = 3
pm.max_spare_servers = 10

05Ошибка в конфигурации пула или PHP

Синтаксическая ошибка в www.conf или в php.ini не даёт пулу стартовать, и nginx получает отказ. Проверьте конфигурацию командой sudo php-fpm8.3 -t. Она покажет файл и строку с ошибкой. После исправления перезагрузите службу.

bash
sudo php-fpm8.3 -t
sudo systemctl reload php8.3-fpm

06Как убедиться, что ошибка устранена

Перезагрузите nginx и php-fpm, затем запросите страницу с сервера через curl. Код ответа должен быть 200, а не 502. Дополнительно проверьте, что в error.log nginx нет новых записей connect() to unix:/run/php/php8.3-fpm.sock failed.

bash
sudo nginx -t && sudo systemctl reload nginx
sudo systemctl reload php8.3-fpm
curl -I http://example.com/
sudo tail -n 20 /var/log/nginx/error.log

Что не помогает

  • Перезапускать только nginx, не проверяя php-fpm.

    Сначала проверьте systemctl status php8.3-fpm и журнал службы. Без работающего пула перезапуск nginx ничего не изменит.

  • Ставить fastcgi_pass 127.0.0.1:9000, когда пул слушает Unix-сокет.

    Приведите fastcgi_pass в соответствие со строкой listen в www.conf. Для сокета укажите unix:/run/php/php8.3-fpm.sock.

  • Бесконечно поднимать pm.max_children без учёта памяти.

    Посчитайте лимит по объёму RAM и среднему потреблению процесса PHP. Избыток процессов приведёт к OOM и новым падениям пула.

  • Менять права на весь каталог /run/php через chmod 777.

    Настройте listen.owner, listen.group и listen.mode в пуле. Права 0660 и владелец www-data закрывают доступ посторонним.

Deploykin

Как это делается в Deploykin

В Deploykin у каждого сайта свой пул PHP-FPM, а его pm.max_children и memory_limit меняются в настройках сайта. Лог PHP-FPM читается в панели, мониторинг снимает метрики PHP-FPM и присылает оповещение, если служба упала.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Почему 502 появляется только на части страниц?

Скорее всего, пул упирается в pm.max_children при всплеске нагрузки, и часть запросов не дожидается свободного процесса. Проверьте лог пула на строку server reached pm.max_children setting.

Где nginx пишет причину 502?

В /var/log/nginx/error.log. Там будет строка вида connect() to unix:/run/php/php8.3-fpm.sock failed с указанием причины: Permission denied или No such file or directory.

Как проверить, что сокет php-fpm существует?

Выполните ls -l /run/php/php8.3-fpm.sock. Если файла нет, служба не запущена или в пуле указан другой путь в listen.

Поможет ли замена fastcgi_pass на TCP-порт?

Да, если в пуле задан listen = 127.0.0.1:9000. Тогда в nginx укажите fastcgi_pass 127.0.0.1:9000;. Оба варианта должны совпадать.

Ещё по теме

PHP-FPM на сервере: настройка, пул и типичные ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.