Ошибка 502 Bad Gateway в nginx: причины и исправление
502 Bad Gateway означает, что nginx принял запрос, но не получил ответ от бэкенда: PHP-FPM, приложения на другом порту или upstream по proxy_pass. Сначала смотрите последние строки в /var/log/nginx/error.log: там указан адрес upstream и причина сбоя.
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.
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.
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-сокета это значит, что файл остался, а процесса нет. Проверьте, какие порты слушаются, и сверьте с конфигом сайта.
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 и в логе приложения.
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.
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.
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. Если ошибка повторяется, смотрите последнюю строку лога: она указывает на следующий шаг.
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 и права.
Ещё по теме
- Ошибка · PHP Ошибка 502 Bad Gateway в связке nginx и php-fpm Почему nginx отдаёт 502 при работе с php-fpm: разбор причин, команды проверки сокета, пула и логов, исправление конфига и перезапуск php8.3-fpm.
- Ошибка · Nginx Ошибка 403 Forbidden в nginx: причины и исправление Разбираем ошибку 403 Forbidden в nginx: как найти причину по error.log, проверить права через namei и sudo -u www-data, исправить chmod и deny. Команды для Ubuntu…
- Ошибка · Nginx nginx error log: как читать и исправлять ошибки Разбираем записи nginx error log: 403, 502, 504, 413 и другие. Показываем, как найти причину по логу, проверить права, сокет PHP-FPM и конфиг, и что сделать для…
- Ошибка · Nginx Ошибка nginx 499: что значит и как исправить Разбираем код 499 в nginx: что значит Client Closed Request, как найти причину в логах, настроить таймауты и проверить, что ошибка ушла.
- Ошибка · Nginx Ошибка 500 Internal Server Error в nginx: поиск причины и исправление Разбираем ошибку 500 в nginx: как найти причину в error.log, проверить PHP-FPM, права и конфиг, исправить и убедиться, что ошибка ушла.
- Руководство · Nginx Docker nginx: установка и настройка обратного прокси Пошагово: установка nginx в Docker на Ubuntu 24.04, конфиг обратного прокси, проверка через curl и разбор частых ошибок с логами.
Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы