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

Ошибка 500 в Laravel: где искать причину и как исправить

Ошибка 500 Internal Server Error в Laravel означает, что PHP-скрипт завершился с фатальной ошибкой или исключением, а nginx не смог отдать ответ. Первым делом смотрите storage/logs/laravel.log и лог PHP-FPM: там будет точный текст исключения и путь к файлу.

Ошибка Деплой 2 мин чтения

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.

bash
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 и очистите конфиг-кеш.

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

nginx
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, чтобы пересобрать автозагрузчик и кеш конфига.

bash
composer install --no-dev --optimize-autoloader
php artisan optimize
php artisan queue:restart

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

Откройте сайт в браузере и проверьте, что отдаётся код 200. Затем посмотрите последние строки storage/logs/laravel.log: новых записей с уровнем ERROR быть не должно. Если ошибка повторяется, включите APP_DEBUG=true на время диагностики и смотрите стек-трейс на странице.

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

Ещё по теме

Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы

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