Поиск
Ошибки

Ошибки Laravel: что значит сообщение и как его исправить

Посетителю Laravel показывает короткую страницу 500 Server Error, а текст ошибки записывает в журнал storage/logs/laravel.log. Откройте журнал, найдите текст ошибки в таблицах ниже и перейдите в разбор — там написано, что значит сообщение и какие команды ввести.

≈ 7 мин чтения
Содержание 13

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

  1. Перейдите в папку проекта: cd /var/www/example.com.
  2. Посмотрите конец журнала: tail -n 50 storage/logs/laravel.log.
  3. Найдите последнюю строку со словом ERROR, а её текст — в таблицах ниже.
  4. Если журнала нет или он пуст — где ещё искать.

Команды вводятся на сервере: подключитесь к нему по 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 modeLaravel не может записать журналРазбор
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Разбор

Формы, вход и маршруты

СообщениеЧто значитРазбор
419 Page Expired или CSRF token mismatch.форма отправлена без действующего токенаРазбор
Route [login] not defined.нет маршрута с именем loginРазбор
Target class […] does not exist.Laravel не нашёл контроллер или middlewareРазбор
Class "…" not foundPHP не нашёл классРазбор

Стили и скрипты

СообщениеЧто значитРазбор
Vite manifest not found at: …/public/build/manifest.jsonстили и скрипты не собраныРазбор
в адресах стилей порт 5173остался файл public/hotРазбор
npm WARN EBADENGINEпакету нужна другая версия Node.jsРазбор
JavaScript heap out of memoryсборке не хватило памятиРазбор

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

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

  1. Проверьте папку журнала: ls -l storage/logs/. Если файла нет или его владелец root — разбор.
  2. Посмотрите журнал ошибок 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.

Источники

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

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

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