Поиск
Ошибки

500 Server Error в Laravel — как найти причину

На рабочем сайте Laravel не показывает посетителям, что сломалось: вместо подробностей — короткая страница 500 Server Error. Сам текст ошибки Laravel записывает в журнал storage/logs/laravel.log. Откройте журнал — последняя запись с ERROR и есть причина.

≈ 6 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Перейдите в папку проекта: cd /var/www/example.com.
  2. Посмотрите конец журнала: tail -n 50 storage/logs/laravel.log.
  3. Найдите последнюю строку со словом ERROR — после двоеточия текст ошибки.
  4. Найдите этот текст в таблице ниже и откройте разбор.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). В папке проекта лежат файл artisan и папки public и storage.

Как выглядит ошибка

Страница Laravel — по центру код и два слова:

500 | Server Error

Если на странице написано 500 Internal Server Error, а внизу nginx, — ошибку показал сам nginx, а не Laravel. Её разбор — на странице 500 Internal Server Error.

Laravel показывает короткую страницу, когда в файле .env стоит APP_DEBUG=false. С APP_DEBUG=true вместо неё открывается полный текст ошибки с кодом и путями к файлам.

Как читать журнал

Laravel пишет ошибки в файл storage/logs/laravel.log. Запись выглядит так:

[2026-11-13 10:00:00] production.ERROR: No application encryption key has been specified. {"exception":"[object] (Illuminate\\Encryption\\MissingAppKeyException(code: 0): … at …)"}
[stacktrace]
#0 …
ЧастьЧто значит
[2026-11-13 10:00:00]дата и время ошибки
productionокружение из строки APP_ENV файла .env
ERRORуровень записи
No application encryption key…текст ошибки — его и ищите в разборах
[stacktrace]цепочка файлов, через которые прошёл запрос; нужна разработчику

Найти последние ошибки без лишнего:

grep 'production.ERROR' storage/logs/laravel.log | tail -n 3 | cut -c1-300

Если в .env другое окружение, например APP_ENV=local, ищите local.ERROR.

Если в папке не один файл, а файлы с датой — laravel-2026-11-13.log, — журнал ведётся по дням. Откройте сегодняшний:

ls storage/logs/
tail -n 50 storage/logs/laravel-2026-11-13.log

Если в журнале пусто

Ошибка случилась до того, как Laravel начал работу, или Laravel не смог её записать.

  1. Laravel не может писать в журнал. Посмотрите, кому принадлежит файл: ls -l storage/logs/. Если root — разбор.
  2. Ошибка в самом PHP. Посмотрите журнал ошибок nginx:
sudo tail -n 20 /var/log/nginx/error.log

Строки с PHP Fatal error или PHP Parse error — ошибка в коде PHP. Строка с vendor/autoload.php значит, что не установлены зависимости: выполните composer install --no-dev --optimize-autoloader.

  1. Журнал пишется не в файл. Проверьте: grep '^LOG_' .env. В новом проекте стоят LOG_CHANNEL=stack и LOG_STACK=single — запись в laravel.log. Если там stderr или syslog, ошибки уходят в журнал PHP-FPM или системы.

Почему APP_DEBUG=true нельзя включать на рабочем сайте

С APP_DEBUG=true Laravel показывает любому посетителю пути к файлам, куски кода и значения настроек. Документация Laravel предупреждает: на рабочем сайте значение должно быть false, иначе посетители увидят конфиденциальные настройки.

Проверьте .env:

grep -E '^APP_(ENV|DEBUG)=' .env

На рабочем сайте должно быть:

APP_ENV=production
APP_DEBUG=false

Внимание: в образце .env.example стоят APP_ENV=local и APP_DEBUG=true. Если файл .env на сервере создали командой cp .env.example .env, режим отладки включён. Поменяйте обе строки и выполните php artisan config:cache.

Вместо включения отладки читайте журнал: в нём тот же текст ошибки.

Если ошибка появилась после переноса на сервер

Порядок первого запуска проекта Laravel на сервере:

composer install --no-dev --optimize-autoloader
cp .env.example .env
nano .env
php artisan key:generate
php artisan migrate --force
npm install
npm run build
sudo chown -R www-data:www-data storage bootstrap/cache
sudo -u www-data php artisan optimize

В nano .env впишите APP_ENV, APP_DEBUG, APP_URL и доступ к базе, затем сохраните: Ctrl+O, Enter, выход — Ctrl+X. Пропущенный шаг даёт свою ошибку — ищите её в таблице ниже.

Ошибки и как их исправить

Текст в laravel.logПричинаРазбор
No application encryption key has been specified.нет APP_KEYРазбор
could not be opened in append modeнет прав на журналРазбор
could not find driverнет модуля PHP для базыРазбор
SQLSTATE[HY000] [2002]база не отвечаетРазбор
SQLSTATE[HY000] [1045] Access denied for userневерный пароль базы в .envРазбор
Base table or view not foundне выполнены миграцииРазбор
Vite manifest not foundне собраны стили и скриптыРазбор
Target class […] does not exist.Laravel не нашёл контроллерРазбор
Please provide a valid cache path.нет папок в storageРазбор
Route [login] not defined.нет страницы входаРазбор
Class "…" not foundPHP не нашёл классРазбор
журнал пустошибка до запуска Laravelсмотрите журнал nginx

Страница с кодом 419 и Page Expired в журнал не пишется — её разбор.

Тексты сообщений сверены по исходному коду Laravel 13.42.0.

Источники

Сверено 13 ноября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше