Ошибка 500 в Laravel: где искать причину и как исправить
Ошибка 500 Internal Server Error в Laravel означает, что PHP-скрипт завершился с фатальной ошибкой или исключением, а nginx не смог отдать ответ. Первым делом смотрите storage/logs/laravel.log и лог PHP-FPM: там будет точный текст исключения и путь к файлу.
01Права на storage и bootstrap/cache
Самая частая причина на VPS: после git clone или распаковки архива каталоги storage и bootstrap/cache принадлежат пользователю, от которого вы деплоили, а PHP-FPM работает под www-data. Laravel не может писать логи и кеш, падает с Permission denied и отдаёт 500. Проверьте владельца командой ls -ld storage bootstrap/cache и при необходимости выполните sudo chown -R www-data:www-data storage bootstrap/cache.
sudo chown -R www-data:www-data storage bootstrap/cache
sudo find storage bootstrap/cache -type d -exec chmod 775 {} \;
sudo find storage bootstrap/cache -type f -exec chmod 664 {} \;
02Не задан APP_KEY
Если в .env пустой APP_KEY, Laravel не может расшифровать сессии и куки и выбрасывает No application encryption key has been specified. Проверьте значение командой grep APP_KEY .env. Если оно пустое, сгенерируйте ключ через php artisan key:generate и очистите конфиг-кеш.
grep APP_KEY .env
php artisan key:generate
php artisan config:clear
03Ошибка в конфиге nginx или PHP-FPM
Синтаксическая ошибка в nginx.conf или недоступный сокет PHP-FPM дают 502 или 500 без записи в laravel.log. Проверьте конфиг через sudo nginx -t и статус сервиса через systemctl status php8.3-fpm. В блоке location ~ \.php$ должен быть корректный fastcgi_pass на сокет /run/php/php8.3-fpm.sock.
server {
listen 80;
server_name example.com;
root /var/www/example.com/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
}
04Ошибка в коде после деплоя
После git pull или composer install в коде может оказаться вызов несуществующего класса или метода. В laravel.log будет строка вида Class "App\Services\Foo" not found с путём к файлу. Выполните composer install --no-dev --optimize-autoloader и php artisan optimize, чтобы пересобрать автозагрузчик и кеш конфига.
composer install --no-dev --optimize-autoloader
php artisan optimize
php artisan queue:restart
05Как убедиться, что ошибка ушла
Откройте сайт в браузере и проверьте, что отдаётся код 200. Затем посмотрите последние строки storage/logs/laravel.log: новых записей с уровнем ERROR быть не должно. Если ошибка повторяется, включите APP_DEBUG=true на время диагностики и смотрите стек-трейс на странице.
curl -I https://example.com
tail -n 50 storage/logs/laravel.log
Что не помогает
-
Ставят права
777наstorageиbootstrap/cache, чтобы быстро убратьPermission denied.Дайте владельца
www-dataи права775на каталоги,664на файлы.777открывает запись любому процессу на сервере. -
Меняют
APP_KEYна работающем проекте без перегенерации сессий.После
php artisan key:generateвсе активные сессии и зашифрованные куки станут недействительны. Предупредите пользователей или выполните смену в окно обслуживания. -
Смотрят только
laravel.log, когда ошибка возникает до загрузки фреймворка.Проверьте лог PHP-FPM:
sudo tail -n 50 /var/log/php8.3-fpm.log. Синтаксические ошибки PHP и падения вpublic/index.phpпишутся туда.
Deploykin
Как это делается в Deploykin
В Deploykin у каждого сайта свой системный пользователь и пул PHP-FPM, а команды в каталоге сайта выполняются от этого пользователя, поэтому права на storage и bootstrap/cache не расходятся. .env правится в панели, laravel.log читается там же, а об ошибке деплоя приходит оповещение.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Где Laravel хранит логи ошибок?
По умолчанию в storage/logs/laravel.log. Путь задаётся в config/logging.php, канал single или daily.
Почему после git pull появилась ошибка 500?
Чаще всего не выполнен composer install или не пересобран кеш конфига. Выполните composer install --no-dev --optimize-autoloader и php artisan optimize.
Как включить подробный вывод ошибки на время диагностики?
Поставьте APP_DEBUG=true и APP_ENV=local в .env, затем php artisan config:clear. После исправления верните APP_DEBUG=false.
Ошибка 500 остаётся, а в laravel.log пусто. Что проверить?
Смотрите /var/log/nginx/error.log и /var/log/php8.3-fpm.log. Ошибка может быть в конфиге nginx, в правах на public/index.php или в недоступном сокете PHP-FPM.
Ещё по теме
- Ошибка · Nginx Ошибка 500 Internal Server Error в nginx: поиск причины и исправление Разбираем ошибку 500 в nginx: как найти причину в error.log, проверить PHP-FPM, права и конфиг, исправить и убедиться, что ошибка ушла.
- Ошибка · Деплой php artisan migrate ошибка: причины и исправление Разбираем ошибки php artisan migrate: отказ доступа к MySQL, неверный.env, права на storage. Команды проверки, конфиг nginx и PHP 8.3, как убедиться, что миграции…
- Ошибка · Деплой Ошибка composer install: как найти причину и исправить Разбираем ошибки composer install: нехватка памяти, права доступа, версия PHP. Команды для диагностики и исправления на Ubuntu 24.04 с nginx, PHP 8.3 и MySQL 8.
- Ошибка · Деплой Ошибка git pull permission denied на VPS: как исправить Разбираем ошибку git pull permission denied на VPS: проверка прав, SSH-ключей, владельца файлов и конфигурации nginx. Команды для диагностики и исправления.
- Ошибка · Деплой Ошибка 419 Page Expired в Laravel: причины и исправление Почему Laravel выдаёт 419 Page Expired: CSRF-токен, cookie сессии, SESSION_DOMAIN, кэш конфига. Как проверить и исправить каждую причину.
- Ошибка · Деплой Ошибка 413 Request Entity Too Large в nginx: как исправить Ошибка 413 в nginx: как найти лимит client_max_body_size, изменить его в конфиге, проверить PHP и перезапустить nginx. Команды и примеры.
Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы