Ошибка 500 Internal Server Error в nginx: поиск причины и исправление
500 Internal Server Error означает, что nginx принял запрос, но не смог получить ответ от бэкенда или столкнулся с внутренней ошибкой. Сначала смотрите /var/log/nginx/error.log: там будет строка с причиной, например таймаут PHP-FPM или падение скрипта.
01Скрипт PHP завершился с фатальной ошибкой
В error.log nginx появляется 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/nginx/error.log
sudo tail -n 50 /var/log/php8.3-fpm.log
02PHP-FPM не запущен или слушает другой сокет
В логе nginx видно connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory). Файла сокета нет: PHP-FPM этой версии не запущен или не установлен, либо в fastcgi_pass указана другая версия PHP. Проверьте список сокетов и статус службы. Если сокета нет, запустите PHP-FPM или поправьте fastcgi_pass под установленную версию.
ls /run/php/
sudo systemctl status php8.3-fpm
03Нет прав на сокет PHP-FPM
В error.log строка 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
04Бэкенд не отвечает: таймаут
В логе 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. Увеличьте pm.max_children или оптимизируйте запрос.
sudo grep -n "pm.max_children" /etc/php/8.3/fpm/pool.d/www.conf
sudo tail -n 50 /var/log/php8.3-fpm.log
05Ошибка в конфиге nginx
Если error.log пуст или в нём нет строк, связанных с запросом, проверьте синтаксис конфига. sudo nginx -t покажет файл и строку с ошибкой. После исправления примените конфиг через sudo systemctl reload nginx: при ошибке nginx продолжит работать со старым конфигом, а новый не применится.
sudo nginx -t
sudo systemctl reload nginx
06Как убедиться, что ошибка 500 ушла
Сделайте запрос к проблемному адресу и проверьте код ответа. В access.log не должно быть записей с кодом 500 на этот URL, а в error.log не появляется новых строк после запроса. Если ошибка повторяется, снова смотрите последние строки error.log: причина могла измениться.
curl -I http://example.com/
sudo tail -n 20 /var/log/nginx/error.log
Что не помогает
-
Сразу менять владельца всех файлов сайта на
www-dataчерезchown -R.Владельцем должен остаться пользователь, который деплоит.
www-dataнужно только чтение, а запись лишь в каталоги, куда пишет сам сайт:storageиbootstrap/cacheу Laravel. -
Ставить
chmod 777на каталог или файл, чтобы nginx точно смог прочитать.Достаточно прав по умолчанию: каталоги 755, файлы 644.
chmod 777не нужен ни для одной ошибки nginx и открывает запись всем. -
Перезапускать nginx через
systemctl restartпри каждой правке конфига.Используйте
sudo systemctl reload nginx: конфиг применится без обрыва соединений. Перед этим проверяйте синтаксис черезsudo nginx -t.
Deploykin
Как это делается в Deploykin
В Deploykin логи nginx, PHP-FPM и приложения читаются в панели, без SSH. Конфиг nginx правится в редакторе: перед сохранением панель проверяет его на сервере, а прежняя версия уходит в резервную копию. Если nginx или PHP-FPM упадёт, придёт оповещение в Telegram.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Где nginx пишет причину ошибки 500?
В /var/log/nginx/error.log, если в конфиге сайта не задан свой error_log. Смотрите последние строки после запроса, который вернул 500.
Почему 500 появляется только на некоторых страницах?
Скорее всего, падает конкретный PHP-скрипт: ошибка в коде или нехватка памяти. Причина будет в /var/log/php8.3-fpm.log и в логе приложения.
Может ли 500 быть из-за прав на файлы?
Обычно при нехватке прав nginx отдаёт 403, а не 500. Но если скрипт не может записать файл в storage или bootstrap/cache, PHP завершится с фатальной ошибкой, и nginx вернёт 500.
Что делать, если в error.log пусто?
Проверьте sudo nginx -t и убедитесь, что запрос вообще доходит до nginx: в access.log должна быть строка с этим URL. Если строки нет, проблема на стороне клиента или DNS.
Ещё по теме
- Ошибка · Деплой Ошибка 500 в Laravel: где искать причину и как исправить Разбираем ошибку 500 в Laravel: где смотреть логи, как проверить права на storage и bootstrap/cache, APP_KEY, синтаксис nginx и PHP-FPM. Команды для диагностики и…
- Ошибка · Nginx Ошибка 502 Bad Gateway в nginx: причины и исправление Разбираем ошибку 502 Bad Gateway в nginx: почему PHP-FPM не отвечает, как читать error.log, проверять сокет и права, чинить таймауты и буферы.
- Ошибка · 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 Docker nginx: установка и настройка обратного прокси Пошагово: установка nginx в Docker на Ubuntu 24.04, конфиг обратного прокси, проверка через curl и разбор частых ошибок с логами.
Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы