Ошибки Laravel: что значит сообщение и как его исправить
Посетителю Laravel показывает короткую страницу 500 Server Error, а текст ошибки записывает в журнал storage/logs/laravel.log. Откройте журнал, найдите текст ошибки в таблицах ниже и перейдите в разбор — там написано, что значит сообщение и какие команды ввести.
Содержание 13
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com. - Посмотрите конец журнала:
tail -n 50 storage/logs/laravel.log. - Найдите последнюю строку со словом
ERROR, а её текст — в таблицах ниже. - Если журнала нет или он пуст — где ещё искать.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). В папке проекта лежат файл artisan и папки public и storage.
Где видно ошибку
| Где | Что видно |
|---|---|
страница сайта, в .env APP_DEBUG=false | код 500 и слова Server Error, без подробностей |
страница сайта, в .env APP_DEBUG=true | полный текст ошибки — только для проверки, не на рабочем сайте |
терминал после php artisan … или composer install | текст ошибки сразу под командой |
файл storage/logs/laravel.log | строка с ERROR и текстом ошибки |
Как читать запись журнала и почему APP_DEBUG=true опасен на рабочем сайте — в разборе 500 Server Error в Laravel.
Запуск и ключ
| Сообщение | Что значит | Разбор |
|---|---|---|
500 Server Error на странице | Laravel записал ошибку в журнал | Разбор |
No application encryption key has been specified. | в .env нет ключа APP_KEY | Разбор |
Unable to set application key. | в .env нет строки APP_KEY= | Разбор |
Unsupported cipher or incorrect key length. | ключ испорчен или не той длины | Разбор |
Could not open input file: artisan | команда запущена не в папке проекта | Разбор |
Права и папки
| Сообщение | Что значит | Разбор |
|---|---|---|
laravel.log could not be opened in append mode | Laravel не может записать журнал | Разбор |
There is no existing directory at … | нет папки storage/logs | Разбор |
Please provide a valid cache path. | нет папок в storage/framework | Разбор |
bootstrap/cache directory must be present and writable | нет папки bootstrap/cache или прав на неё | Разбор |
картинки по адресу /storage/… дают 404 | нет ссылки public/storage | Разбор |
The […/public/storage] link already exists. | на месте ссылки что-то уже есть | Разбор |
База данных
| Сообщение | Что значит | Разбор |
|---|---|---|
could not find driver | в PHP нет модуля для базы | Разбор |
SQLSTATE[HY000] [2002] | Laravel не подключается к MySQL | Разбор |
SQLSTATE[HY000] [1045] Access denied for user | неверный логин или пароль базы в .env | Разбор |
Base table or view not found | не выполнены миграции | Разбор |
SQLSTATE[08006] [7] connection to server at … | Laravel не подключается к PostgreSQL | Разбор |
Database file at path […] does not exist. | нет файла базы SQLite | Разбор |
Формы, вход и маршруты
Стили и скрипты
Если журнала нет или он пуст
Ошибка случилась до запуска Laravel, или Laravel не смог её записать.
- Проверьте папку журнала:
ls -l storage/logs/. Если файла нет или его владелец root — разбор. - Посмотрите журнал ошибок nginx:
sudo tail -n 20 /var/log/nginx/error.log| Что в журнале nginx | Где разбор |
|---|---|
PHP Fatal error или PHP Parse error | Ошибки PHP |
vendor/autoload.php | не установлены зависимости: composer install --no-dev --optimize-autoloader |
страница 502 Bad Gateway | Разбор |
connect() to unix:/run/php/… | Ошибки PHP-FPM |
Если правка .env не действует
Если на сервере выполняли php artisan config:cache или php artisan optimize, Laravel берёт настройки из файла bootstrap/cache/config.php, а .env не читает. Проверьте:
ls bootstrap/cache/config.phpЕсли файл есть, после каждой правки .env выполните одну из команд:
php artisan config:clear
php artisan config:cacheПервая удаляет кеш настроек, вторая собирает его заново из нового .env. На рабочем сайте лучше вторая, от пользователя сайта: sudo -u www-data php artisan config:cache.
Права на storage и bootstrap/cache
Laravel пишет в две папки: storage — журнал, кеш, сессии, загруженные файлы — и bootstrap/cache. Сайт работает от www-data, поэтому папки должны принадлежать ему:
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cacheЕсли папки на месте, эти две команды убирают ошибки записи журнала и кеша из таблицы «Права и папки». Подробнее — в разборе Please provide a valid cache path и в инструкции Права на файлы сайта.
Откуда тексты
Тексты сообщений сверены по исходному коду Laravel 13.42.0. Текст Could not open input file пишет сам PHP — он сверен по исходному коду PHP 8.3.6, который ставится из пакетов Ubuntu 24.04. Свою версию Laravel покажет команда php artisan --version.
Источники
- Документация Laravel: Error Handling — на английском: APP_DEBUG и запись ошибок в журнал.
- Документация Laravel: Logging — на английском: журнал storage/logs/laravel.log.
- Документация Laravel: Configuration — на английском: config:cache и то, что после него .env не загружается.
- Документация Laravel: Deployment — на английском: права на storage и bootstrap/cache, оптимизация.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки PHPошибки самого PHP по тексту сообщения.
- Ошибки Composerесли не ставятся пакеты проекта.
- Ошибки PHP-FPMесли сайт отвечает 502.
- VPS для разработчикакакой сервер взять под проект.
- Laravel на серверекак установить и настроить проект на VPS по шагам.