Laravel: Route [login] not defined — нет страницы входа
Страницы для своих защищает middleware auth. Если на такую страницу заходит гость, Laravel отправляет его на страницу входа — на маршрут с именем login. Ошибка значит, что маршрута с таким именем в проекте нет. Нужно дать имя странице входа или указать Laravel другой адрес.
Содержание 9
Что сделать прямо сейчас
- Проверьте, есть ли маршрут с именем login:
php artisan route:list --name=login. - Если страница входа есть, но с другим именем, допишите к ней
->name('login')— как. - Если страница входа по другому адресу, укажите его в
bootstrap/app.php— как. - Если ошибка в запросах к API, отправляйте заголовок
Accept: application/json— почему.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды выполняются в папке проекта, например cd /var/www/example.com.
Как выглядит ошибка
Route [login] not defined.С APP_DEBUG=false в файле .env посетитель видит 500 и Server Error, а ошибка записана в storage/logs/laravel.log.
Ошибка появляется не на странице входа, а на закрытой странице, когда её открывает гость. Вошедший пользователь ошибку не увидит, поэтому разработчик может её не заметить.
Почему так бывает
У маршрута в Laravel может быть имя — его задают ->name('…'). Middleware auth пропускает только вошедших. Гостя оно отправляет на маршрут с именем login: так Laravel настроен в новом проекте.
Маршрута с этим именем нет, если:
- в проекте нет страницы входа — например, проект создали без готового набора для входа;
- страница входа есть, но с другим именем или без имени;
- вход находится по другому адресу, например
/admin/login, и маршрут называется иначе.
Если страница входа есть
Откройте файл маршрутов routes/web.php и найдите страницу входа. Допишите имя:
Route::get('/login', [LoginController::class, 'show'])->name('login');Вместо LoginController и show — ваши контроллер и метод. Имя login должно быть ровно таким, маленькими буквами.
Если маршруты закешированы, обновите кеш:
php artisan route:clearПроверьте: php artisan route:list --name=login — в ответе строка с вашим адресом.
Если вход по другому адресу
Если страница входа у вас, например, /admin/login, скажите Laravel отправлять гостей туда. В файле bootstrap/app.php:
->withMiddleware(function (Middleware $middleware): void {
$middleware->redirectGuestsTo('/admin/login');
})Laravel отправит гостя по этому адресу, а имя маршрута искать не будет.
Если страницы входа в проекте нет совсем, её нужно сделать. Laravel предлагает готовые наборы для входа и регистрации — они описаны в документации Laravel.
Если ошибка в запросах к API
Если запрос к закрытому адресу API пришёл без заголовка Accept: application/json, Laravel считает его запросом браузера и пытается отправить на страницу входа. Отсюда и ошибка.
С заголовком Laravel отвечает кодом 401 и текстом:
{"message":"Unauthenticated."}Проверить с сервера:
curl -i -H 'Accept: application/json' https://example.com/api/userВ первой строке ответа должно быть 401. Если так — в программе, которая обращается к API, добавьте заголовок Accept: application/json к каждому запросу.
Если менять программу нельзя, настройте ответ на стороне Laravel — для адресов api/* не отправлять на страницу входа:
use Illuminate\Http\Request;
->withMiddleware(function (Middleware $middleware): void {
$middleware->redirectGuestsTo(
fn (Request $request) => $request->is('api/*') ? null : route('login')
);
})Тогда гость получит на адресах API пустой ответ с кодом 401.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Route [login] not defined. на закрытой странице | нет маршрута с именем login | дайте имя странице входа |
то же, вход по адресу /admin/login | маршрут называется иначе | redirectGuestsTo |
| то же в запросах к API | нет заголовка Accept: application/json | добавьте заголовок |
| имя добавили, ошибка осталась | маршруты закешированы | php artisan route:clear |
Route [dashboard] not defined. или другое имя | в коде route('…') с именем, которого нет | найдите имя в routes/web.php или добавьте его |
Target class […] does not exist. | Laravel не нашёл контроллер или middleware | Разбор |
Тексты сообщений сверены по исходному коду Laravel 13.42.0.
Источники
- Документация Laravel: Authentication — на английском: middleware auth и перенаправление гостей.
- Документация Laravel: Routing — на английском: имена маршрутов.
- Исходный код UrlGenerator в Laravel 13.42.0 — на английском: текст Route not defined.
- Исходный код Handler в Laravel 13.42.0 — на английском: ответ 401 и текст Unauthenticated.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Ошибки Laravelвсе ошибки Laravel на одной странице.
- Коды ответа HTTPчто значит 401 и другие коды.
- 500 Server Error в Laravelкак найти причину в журнале.