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

Ошибка 500 Internal Server Error в nginx: поиск причины и исправление

500 Internal Server Error означает, что nginx принял запрос, но не смог получить ответ от бэкенда или столкнулся с внутренней ошибкой. Сначала смотрите /var/log/nginx/error.log: там будет строка с причиной, например таймаут PHP-FPM или падение скрипта.

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

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 и в логе приложения. Исправьте ошибку в коде или увеличьте таймаут в пуле, если скрипт действительно долгий.

bash
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 под установленную версию.

bash
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 права сбросятся.

bash
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 или оптимизируйте запрос.

bash
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 продолжит работать со старым конфигом, а новый не применится.

bash
sudo nginx -t
sudo systemctl reload nginx

06Как убедиться, что ошибка 500 ушла

Сделайте запрос к проблемному адресу и проверьте код ответа. В access.log не должно быть записей с кодом 500 на этот URL, а в error.log не появляется новых строк после запроса. Если ошибка повторяется, снова смотрите последние строки error.log: причина могла измениться.

bash
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.

Ещё по теме

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

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