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

Ошибка 502 Bad Gateway в nginx: причины и исправление

502 Bad Gateway означает, что nginx принял запрос, но не получил ответ от бэкенда: PHP-FPM, приложения на другом порту или upstream по proxy_pass. Сначала смотрите последние строки в /var/log/nginx/error.log: там указан адрес upstream и причина сбоя.

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

01Сокета PHP-FPM нет: (2: No such file or directory)

В логе строка connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory). Это значит, что файла сокета нет: PHP-FPM версии 8.3 не запущен или не установлен, либо в fastcgi_pass указана другая версия PHP. Проверьте список сокетов и статус службы, затем запустите её и перезагрузите nginx.

bash
ls /run/php/
sudo systemctl status php8.3-fpm
sudo systemctl start php8.3-fpm
sudo nginx -t
sudo systemctl reload nginx

02Сокет есть, но нет доступа: (13: Permission denied)

В логе connect() to unix:/run/php/php8.3-fpm.sock failed (13: Permission denied). Файл сокета существует, но www-data не может к нему подключиться: в пуле изменены listen.owner, listen.group или listen.mode. Права сокета задаются в /etc/php/8.3/fpm/pool.d/www.conf, ручной chown сбросится при перезапуске PHP-FPM.

bash
sudo grep -n "listen" /etc/php/8.3/fpm/pool.d/www.conf
sudo systemctl restart php8.3-fpm
sudo systemctl reload nginx

03По адресу upstream никто не слушает: (111: Connection refused)

В логе connect() failed (111: Connection refused) while connecting to upstream. По адресу из proxy_pass или fastcgi_pass никто не принимает соединения: приложение не запущено или слушает другой порт. Для unix-сокета это значит, что файл остался, а процесса нет. Проверьте, какие порты слушаются, и сверьте с конфигом сайта.

bash
sudo ss -ltnp
sudo grep -n "proxy_pass\|fastcgi_pass" /etc/nginx/sites-enabled/example.com

04PHP-FPM оборвал запрос: (104: Connection reset by peer)

В логе recv() failed (104: Connection reset by peer) или upstream prematurely closed connection. PHP-FPM принял соединение и закрыл его: скрипт упал с фатальной ошибкой или его остановил request_terminate_timeout. Причина видна в /var/log/php8.3-fpm.log и в логе приложения.

bash
sudo tail -n 50 /var/log/php8.3-fpm.log
sudo grep -n "request_terminate_timeout" /etc/php/8.3/fpm/pool.d/www.conf

05Заголовки ответа не влезают в буфер: upstream sent too big header

В логе upstream sent too big header while reading response header from upstream. Заголовки ответа, чаще всего большие cookie, не помещаются в буфер. Для PHP-FPM помогают fastcgi_buffer_size 32k; и fastcgi_buffers 8 16k;, для прокси proxy_buffer_size и proxy_buffers.

nginx
location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    fastcgi_buffer_size 32k;
    fastcgi_buffers 8 16k;
}

06Бэкенд не ответил за 60 секунд: 504 Gateway Time-out

В логе upstream timed out (110: Connection timed out) while reading response header from upstream. Бэкенд не ответил за fastcgi_read_timeout или proxy_read_timeout, по умолчанию это 60 секунд. Причины две: медленный запрос или все процессы PHP-FPM заняты, и запрос ждёт в очереди. Во втором случае в /var/log/php8.3-fpm.log есть server reached pm.max_children setting.

bash
sudo grep -n "pm.max_children\|pm.start_servers" /etc/php/8.3/fpm/pool.d/www.conf
sudo tail -n 50 /var/log/php8.3-fpm.log

07Проверка, что 502 больше не появляется

Перезагрузите nginx и повторите запрос, который падал. В ответе должен быть код 200 или 302, а в /var/log/nginx/error.log не должно появиться новых строк с connect() или upstream. Если ошибка повторяется, смотрите последнюю строку лога: она указывает на следующий шаг.

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

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

  • Сразу выставляют chmod 777 на каталог сайта, чтобы убрать 502 или 403.

    Права по умолчанию: каталоги 755, файлы 644. chmod 777 не нужен ни для одной ошибки nginx и открывает запись в код сайта.

  • Делают chown -R www-data на весь сайт.

    Владелец файлов сайта это пользователь, который деплоит. www-data нужно только чтение, а запись лишь в storage и bootstrap/cache у Laravel или wp-content/uploads у WordPress.

  • Вручную меняют владельца сокета PHP-FPM через chown.

    Права сокета задаются в /etc/php/8.3/fpm/pool.d/www.conf через listen.owner, listen.group и listen.mode. Ручной chown сбросится при перезапуске PHP-FPM.

  • Правят конфиг и перезапускают nginx, не проверив его через nginx -t.

    Сначала sudo nginx -t. При ошибке в конфиге nginx продолжит работать со старым, и вы будете искать причину не там.

Deploykin

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

В Deploykin логи nginx, PHP-FPM и приложения читаются в панели, без SSH. Конфиг nginx правится в редакторе: перед сохранением панель проверяет его на сервере, а прежняя версия уходит в резервную копию. Если nginx или PHP-FPM упадёт, придёт оповещение в Telegram.

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

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

Чем 502 отличается от 504 в nginx?

502 значит, что бэкенд не ответил или ответил ошибкой соединения. 504 значит, что бэкенд не успел ответить за fastcgi_read_timeout или proxy_read_timeout, по умолчанию 60 секунд.

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

В /var/log/nginx/error.log, если в конфиге сайта не заданы свои access_log и error_log. В строке будет адрес upstream и код ошибки соединения.

Почему 502 появился после обновления PHP?

В fastcgi_pass указан сокет старой версии, например php8.2-fpm.sock, а запущен PHP-FPM 8.3. Сверьте путь в конфиге сайта с тем, что лежит в /run/php/.

Поможет ли увеличение таймаута при 502?

Нет, 502 это ошибка соединения, а не таймаут. Увеличение fastcgi_read_timeout влияет на 504, а при 502 сначала проверяют сокет, процесс PHP-FPM и права.

Ещё по теме

Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы

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