Ошибка 502 Bad Gateway в связке nginx и php-fpm
502 Bad Gateway означает, что nginx принял запрос, но не смог получить ответ от php-fpm: процесс не запущен, сокет недоступен или пул упал при обработке. Сначала проверьте статус службы php8.3-fpm и путь к сокету в конфиге nginx, затем смотрите логи пула.
01Служба php8.3-fpm не запущена или упала
Самая частая причина: процесс php-fpm остановлен, перезапускается после падения или не стартовал после установки. Проверьте статус командой systemctl status php8.3-fpm. Если в выводе inactive (dead) или failed, запустите службу и посмотрите журнал journalctl -u php8.3-fpm -n 50.
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.
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.
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 с запасом по памяти и перезагрузите службу.
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. Она покажет файл и строку с ошибкой. После исправления перезагрузите службу.
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.
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;. Оба варианта должны совпадать.
Ещё по теме
- Ошибка · Nginx Ошибка 502 Bad Gateway в nginx: причины и исправление Разбираем ошибку 502 Bad Gateway в nginx: почему PHP-FPM не отвечает, как читать error.log, проверять сокет и права, чинить таймауты и буферы.
- Ошибка · PHP Ошибка php-fpm permission denied: причины и исправление Разбираем ошибку php-fpm permission denied: почему PHP-FPM не запускается и не читает сокет, как проверить права на /run/php и /var/www, исправить конфиг пула и…
- Ошибка · PHP Ошибка PHP Fatal error: Allowed memory size exhausted Как найти и устранить ошибку нехватки памяти в PHP: проверка memory_limit, настройка php.ini и PHP-FPM, команды для диагностики и исправления.
- Ошибка · PHP Ошибка php session permission denied: причины и исправление Ошибка php session permission denied: как найти причину по правам на /var/lib/php/sessions, исправить владельца и права, настроить session.save_path и проверить…
- Руководство · PHP Где находится php.ini и как настроить PHP-FPM на Ubuntu 24.04 Пошаговая настройка php.ini для PHP 8.3 и PHP-FPM на Ubuntu 24.04: где лежит файл, команды проверки, правка лимитов и перезагрузка службы.
- Руководство · PHP PHP 8.3 на Ubuntu 24.04: установка и настройка PHP-FPM Пошаговая установка и настройка PHP 8.3 с PHP-FPM на Ubuntu 24.04: команды, правка пула www, проверка версии и работы сайта.
PHP-FPM на сервере: настройка, пул и типичные ошибки: все материалы темы