500 Server Error в Laravel — как найти причину
На рабочем сайте Laravel не показывает посетителям, что сломалось: вместо подробностей — короткая страница 500 Server Error. Сам текст ошибки Laravel записывает в журнал storage/logs/laravel.log. Откройте журнал — последняя запись с ERROR и есть причина.
Содержание 9
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com. - Посмотрите конец журнала:
tail -n 50 storage/logs/laravel.log. - Найдите последнюю строку со словом
ERROR— после двоеточия текст ошибки. - Найдите этот текст в таблице ниже и откройте разбор.
Команды вводятся на сервере: подключитесь к нему по 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 не смог её записать.
- Laravel не может писать в журнал. Посмотрите, кому принадлежит файл:
ls -l storage/logs/. Если root — разбор. - Ошибка в самом 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.
- Журнал пишется не в файл. Проверьте:
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 found | PHP не нашёл класс | Разбор |
| журнал пуст | ошибка до запуска Laravel | смотрите журнал nginx |
Страница с кодом 419 и Page Expired в журнал не пишется — её разбор.
Тексты сообщений сверены по исходному коду Laravel 13.42.0.
Источники
- Документация Laravel: Error Handling — на английском: APP_DEBUG и запись ошибок в журнал.
- Документация Laravel: Logging — на английском: каналы журнала и LOG_CHANNEL.
- Документация Laravel: Deployment — на английском: оптимизация и режим отладки на рабочем сайте.
- Образец .env.example в Laravel — на английском: APP_ENV=local и APP_DEBUG=true.
- Страница 500 в Laravel — на английском: текст Server Error.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки Laravelвсе ошибки Laravel на одной странице.
- 500 Internal Server Errorесли ошибку показывает nginx.
- VPS для разработчикакакой сервер взять под проект.
- Журналы Laravelкак читать laravel.log и разбить его по дням.