Поиск
Ошибки

Laravel: Target class does not exist — Laravel не находит класс

Laravel сам создаёт контроллеры и middleware, когда к сайту приходит запрос. Ошибка Target class does not exist значит, что класса с таким именем Laravel не нашёл. В квадратных скобках — имя, которое он искал: по нему видно, где ошибка.

≈ 5 мин чтения
Содержание 8

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

  1. Посмотрите, что стоит в квадратных скобках в тексте ошибки.
  2. Если там полное имя вроде App\Http\Controllers\UserController — проверьте, что файл app/Http/Controllers/UserController.php есть и имя написано с теми же большими и маленькими буквами — как проверить.
  3. Если там одно слово без App\ — например, UserController или admin, — смотрите раздел про короткое имя.
  4. Сбросьте кеш маршрутов: php artisan route:clear.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды выполняются в папке проекта, например cd /var/www/example.com.

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

Target class [App\Http\Controllers\UserController] does not exist.

С APP_DEBUG=true в файле .env текст виден на странице. С APP_DEBUG=false посетитель видит 500 и Server Error, а ошибка записана в storage/logs/laravel.log.

Laravel выдаёт эту ошибку, когда PHP не может найти класс по имени. Класс ищется по имени файла и папки: App\Http\Controllers\UserController — это файл app/Http/Controllers/UserController.php.

Если в скобках полное имя контроллера

Проверьте, что файл есть:

ls app/Http/Controllers/
Что видитеЧто сделать
файла нетзагрузите его на сервер или поправьте имя в routes/web.php
файл есть, но буквы в имени другие: Usercontroller.phpпереименуйте файл, чтобы имя совпало с именем класса
файл лежит в другой папкепоправьте имя в строке use в файле маршрутов

Почему на компьютере работало, а на сервере нет. В Windows и macOS UserController.php и Usercontroller.php — один и тот же файл. В Linux — два разных. Переименовать файл на сервере:

mv app/Http/Controllers/Usercontroller.php app/Http/Controllers/UserController.php

Внутри файла проверьте две строки — они должны совпадать с именем и папкой:

namespace App\Http\Controllers;

class UserController extends Controller

Если в скобках короткое имя

Контроллер без App\

Target class [UserController] does not exist.

В файле маршрутов контроллер записан строкой без пути, например 'UserController@index'. Так писали в старых версиях Laravel. Начиная с Laravel 8 путь к контроллеру нужно указать. Подключите класс в начале routes/web.php и укажите его в маршруте:

use App\Http\Controllers\UserController;

Route::get('/users', [UserController::class, 'index']);

Middleware без псевдонима

Target class [admin] does not exist.

В маршруте стоит ->middleware('admin'), но Laravel не знает, какой класс скрывается за словом admin. Задайте псевдоним в файле bootstrap/app.php:

use App\Http\Middleware\EnsureUserIsAdmin;

->withMiddleware(function (Middleware $middleware): void {
    $middleware->alias([
        'admin' => EnsureUserIsAdmin::class,
    ]);
})

Вместо EnsureUserIsAdmin — ваш класс из папки app/Http/Middleware. Псевдонимы auth, guest, verified, throttle, signed, can и ещё несколько в Laravel уже заданы — их добавлять не нужно.

В старых версиях Laravel псевдонимы задавались в файле app/Http/Kernel.php. В новых проектах Laravel 11 и новее этого файла нет — псевдонимы задают в bootstrap/app.php.

Если файл и имя верные

Маршруты закешированы. Команда php artisan route:cache или php artisan optimize сохраняет маршруты в файл. Если после этого поменяли routes/web.php, Laravel работает со старым списком. Сбросьте кеш:

php artisan route:clear

Если кеш маршрутов нужен, после правки снова выполните php artisan route:cache.

Composer не знает о новом классе. Если зависимости ставили с ключом --classmap-authoritative, Composer ищет классы только по готовому списку, и нового файла в нём нет. Обновите список:

composer dump-autoload

Composer не запускайте через sudo — почему.

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

Что видитеПричинаЧто делать
Target class [App\Http\Controllers\…] does not exist.нет файла или буквы в имени другиепроверьте файл
Target class [UserController] does not exist.контроллер записан без путидобавьте use
Target class [admin] does not exist.не задан псевдоним middlewareзадайте alias
ошибка осталась после правки маршрутовмаршруты закешированыphp artisan route:clear
Class "…" not foundPHP не нашёл класс в коде, а не в маршрутеРазбор
Target [...] is not instantiable.Laravel не может создать интерфейс без привязки к классуукажите класс для интерфейса в сервис-провайдере

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

Источники

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

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

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