PHP-FPM LinuxPHP 8.xNginx/Apache

PHP-FPM: ошибка 502 после очистки каталога Unix-сокетов

  • Обновлено
  • Чтение ≈ 4 минуты
  • Нужны права администратора

Краткий ответ

Этот случай специфичен для удаления каталога или файла сокета при ещё работающем PHP-FPM: статус службы может быть активным, но Nginx больше не видит путь, указанный в fastcgi_pass.

В этой статье
  1. Симптомы и отличие от похожих неисправностей
  2. Диагностика и пошаговое устранение
  3. Как проверить результат и что предпринять при неуспехе

#Симптомы и отличие от похожих неисправностей

После очистки /run/php или другого каталога временных сокетов Nginx возвращает 502 Bad Gateway, хотя до очистки сайт работал. Как отличить удалённый сокет от неисправной службы и восстановить связь без безусловного удаления файлов. Этот случай специфичен для удаления каталога или файла сокета при ещё работающем PHP-FPM: статус службы может быть активным, но Nginx больше не видит путь, указанный в fastcgi_pass.

Возможная причинаКак узнатьЧто делать
Удалён путь сокета работающего процессаUnix-сокет удалили из файловой системы, но запущенный работник продолжает держать ранее открытый объект.В Nginx connect() to unix:... failed (2: No such file or directory), а systemctl сообщает active.Проверить путь и безопасно пересоздать сокет штатной службой.
При очистке удалился и каталогРодительский каталог для listen отсутствует и FPM не способен заново создать файл.При перезапуске FPM пишет No such file or directory или отказ bind.Восстановить каталог штатной службой/панелью и проверить владельца.
Nginx и FPM смотрят в разные местаПосле обновления версии или перезапуска сервиса сменилось имя сокета, а fastcgi_pass остался старым.Один путь указан в Nginx, другой в listen работающего пула.Сверить конфигурации и изменить только неверную сторону.

#Диагностика и пошаговое устранение

  1. Воспроизведите один запрос и запишите ошибку NginxОткройте нужный сайт в браузере без выполнения тяжёлых задач. В панели хостинга найдите «Журнал ошибок» Nginx за текущее время или попросите администратора показать его. Ищите connect() to unix:/run/php/...sock failed (2: No such file or directory) и выпишите точный путь. Если указан Permission denied (13), это другая ситуация: файл есть, но доступ запрещён, и восстановление каталога не поможет.
  1. Найдите службу и убедитесь, что она обслуживает нужный сайтПодключитесь по SSH: из терминала Windows/Linux выполните ssh пользователь@сервер, используя собственные учётные данные. Командой systemctl list-units --type=service --all "php*-fpm.service" определите названия. У нескольких PHP может быть по разному сокету; сверяйте имя пула из панели домена и Nginx, а не выбирайте первую активную службу.
    Linux · Терминал (Bash)Команда
    Проверка названия службы без изменений. Нестандартные сервисы панели могут называться иначе.
    systemctl list-units --type=service --all "php*-fpm.service"
  1. Сопоставьте fastcgi_pass и listenВ панели управления откройте конфигурацию сайта или попросите администратора выполнить sudo nginx -T в закрытом сеансе; вывод содержит всю конфигурацию и может включать внутренние адреса. Найдите fastcgi_pass unix:/run/php/...sock; для домена, затем listen = ... в соответствующем пуле. Пути должны совпадать до символа. Если указан 127.0.0.1:9000, это TCP-соединение, и тема очистки Unix-сокетов к нему не относится.
  1. Проверьте существование файла и его родительского каталогаНа сервере выполните ls -ld /run/php и ls -l /run/php только если эта директория присутствует в найденном пути; иначе подставьте правильный каталог. ls покажет владельца, права и список сокетов; при «No such file or directory» отсутствие подтверждено. Не создавайте файл .sock вручную: это не обычный файл, а адрес слушающего процесса.
  2. Для примера Debian /run/php
    Linux · Терминал (Bash)Команда
    Для примера Debian /run/php. Без sudo, только просмотр. Не подставляйте путь, если ваша панель использует другой каталог.
    ls -ld /run/php
    ls -l /run/php
  1. Убедитесь, что FPM не потерял родительский каталог при очисткеЕсли отсутствует весь /run/php, проверьте, как он создаётся при запуске службы: на systemd-системах часть временных каталогов создаёт RuntimeDirectory или пакетная настройка. Не делайте слепое mkdir -p с произвольными правами: при следующей перезагрузке каталог может снова исчезнуть. Сначала проверьте настройки службы и панель, при необходимости восстановите пакетное описание у администратора.
  1. Дополнительная команда по теме
    Linux · Терминал (Bash)С осторожностьюНужен sudo
    Пример для Debian PHP 8.2: после теста конфигурации повторное создание сокета штатным процессом. Нужны права администратора. Команда перезагрузки выполняется только при успешной проверке конфигурации (оператор &&). При ошибке исправьте конфигурацию и повторите проверку; не запускайте перезагрузку вручную.
    sudo php-fpm8.2 -t && sudo systemctl restart php8.2-fpm

    Команда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.

  2. Восстановите сокет штатной перезагрузкой нужного пулаЕсли listen и fastcgi_pass совпадают, каталог присутствует и служба активна, согласуйте кратковременный перерыв: исчезнувший сокет обычно требует перезапуска управляющего FPM, а не nginx. Выполните sudo php-fpm8.2 -t; только после успешного теста sudo systemctl restart php8.2-fpm, заменив версию и имя службы. Перезапуск прерывает запросы этого пула, поэтому заранее завершите критические загрузки и импорты.
  1. Если файл появился, но 502 сохранилась, проверьте разрешенияПосмотрите фактический владелец и группу сокета, сопоставьте с пользователем Nginx и директивами listen.owner, listen.group, listen.mode пула. При журнале Permission denied исправляйте группу/ACL в настройке пула, не ставьте 777. Если connect() failed (111: Connection refused), сервис мог сразу завершиться после запуска — вернитесь к его журналу. Ожидаемый результат: файл создан и обслуживает входящие соединения.
  1. Проверьте сайт и исключите повторную очистку живого сокетаПовторите запрос на обычную PHP-страницу и убедитесь в корректном ответе 200 (либо ожидаемом ответе приложения) и отсутствии новых строк с No such file or directory. Найдите источник очистки: ручной скрипт, cron или служебная процедура панели. Исправьте её так, чтобы не удалять действующие сокеты. При отрицательном результате не повторяйте очистку, а соберите три факта: точный fastcgi_pass, текущий listen и сообщение журнала.

#Как проверить результат и что предпринять при неуспехе

Успех — сокет существует, FPM запущен, Nginx подключается к пути из fastcgi_pass, а браузер не получает 502. Если ошибка повторяется после очистки по расписанию, исправляйте её источник; восстановление одного файла не устранит причину. При необходимости верните исходную конфигурацию пула и веб-сервера из резервных копий.

Так эту ошибку тоже называют

PHP-FPM: server reached pm.max_children setting — причины и решение Предупреждение PHP-FPM «server reached pm.max_children setting» означает, что все процессы заняты. Рассчитайте max_children по памяти, найдите долгие запросы через slowl… Сайты, серверы и хостинг PHP-FPM Linux PHP-FPM: как рассчитать pm.max_children по памяти — причины и решение Предупреждение pm.max_children reached в PHP-FPM означает исчерпание пула процессов. Рассчитайте max_children по доступной памяти и среднему размеру процесса, выберите р… Сайты, серверы и хостинг PHP-FPM Linux PHP-FPM: запросы выполняются медленно, в логе slowlog — причины и решение Медленные запросы и таймауты в PHP-FPM (502/504) исправляются включением slowlog, настройкой request_terminate_timeout, fastcgi_read_timeout в nginx, оптимизацией запрос… Сайты, серверы и хостинг PHP-FPM Linux PHP-FPM: connect() to unix socket failed (13: Permission denied) — причины и решение Ошибка «connect() to unix:/run/php/php-fpm.sock failed (13: Permission denied)» исправляется настройкой listen.owner, listen.group и listen.mode в пуле PHP-FPM под польз… Сайты, серверы и хостинг PHP-FPM Linux PHP-FPM: server reached pm.max_children и ответы 503/504 — причины и решение Предупреждение значит, что все процессы заняты. Найдите медленные запросы, увеличьте max_children при наличии памяти и включите кэширование. Сайты, серверы и хостинг PHP-FPM Linux

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.