К содержимому

Ошибка 419 Page Expired в Laravel: причины и исправление

Ответ 419 Page Expired значит, что Laravel не нашёл в сессии CSRF-токен отправленной формы. Сначала проверьте, есть ли в форме директива @csrf и совпадает ли SESSION_DOMAIN в .env с доменом сайта.

Ошибка Деплой 3 мин чтения

01В форме нет @csrf или в AJAX нет заголовка X-CSRF-TOKEN

Laravel отклоняет POST, PUT, PATCH и DELETE без действующего токена. Откройте исходный код страницы с формой и поищите скрытое поле _token. Если его нет, добавьте @csrf сразу после открывающего тега <form>. Для AJAX-запросов токен передают заголовком X-CSRF-TOKEN. Возьмите его из мета-тега <meta name="csrf-token" content="{{ csrf_token() }}"> и подставьте в настройки запроса.

php
<form method="POST" action="/profile">
    @csrf
    <input type="text" name="name">
    <button type="submit">Сохранить</button>
</form>

02Cookie сессии не сохраняется или не возвращается

Если токен в форме есть, а 419 повторяется, браузер не присылает cookie сессии. Проверьте значение SESSION_DOMAIN в .env: оно должно совпадать с доменом, на котором открыт сайт, или быть пустым. При SESSION_SECURE_COOKIE=true cookie отдаётся только по HTTPS, и на сайте без сертификата сессия не сохранится. Посмотрите cookie в инструментах разработчика браузера на вкладке Application. Запись вида laravel_session должна появляться после первого запроса и уходить обратно в заголовке Cookie.

ini
SESSION_DRIVER=database
SESSION_LIFETIME=120
SESSION_DOMAIN=.example.com
SESSION_SECURE_COOKIE=false

03Нет таблицы sessions или записи в storage/framework/sessions

В Laravel 11 и новее драйвер сессий по умолчанию database, и ему нужна таблица sessions. Проверьте её наличие в MySQL и при отсутствии выполните миграции. Если в SESSION_DRIVER указан file, сессии пишутся в storage/framework/sessions, и у www-data должно быть право записи в этот каталог.

bash
php artisan migrate --force
sudo chown -R $USER:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache

04Сессия истекла по SESSION_LIFETIME

По умолчанию сессия живёт 120 минут. Если пользователь держал форму открытой дольше, токен в ней устарел, и отправка даёт 419. Увеличьте SESSION_LIFETIME в .env, если формы на сайте заполняют долго. После правки .env примените новый конфиг командой php artisan optimize, иначе Laravel продолжит работать со старым значением из кэша.

ini
SESSION_LIFETIME=480

05Страница с формой закэширована

Если страница с формой отдаётся из кэша nginx или из кэша шаблонов, посетитель получает токен, выпущенный для другой сессии. Проверьте, не стоит ли для маршрута с формой кэширование ответа. Формы и страницы, зависящие от сессии, кэшировать нельзя.

06Конфиг закэширован со старыми значениями.env

После php artisan optimize значения из .env читаются из кэша конфига, и правка файла без пересборки кэша ни на что не влияет. Если вы меняли SESSION_DOMAIN, SESSION_DRIVER или SESSION_SECURE_COOKIE, выполните php artisan optimize заново от владельца проекта, без sudo.

bash
php artisan optimize
php artisan config:clear

07Как убедиться, что ошибка ушла

Очистите cookie сайта в браузере, откройте форму заново и отправьте её. В инструментах разработчика проверьте, что запрос уходит с заголовком Cookie и полем _token, а ответ имеет код 200 или 302. Повторите отправку после истечения SESSION_LIFETIME, чтобы убедиться, что сессия продлевается.

bash
tail -n 50 storage/logs/laravel.log

Что не помогает

  • Правка fastcgi_param в конфиге nginx, чтобы передать Cookie или X-CSRF-TOKEN в PHP-FPM.

    nginx передаёт заголовки запроса в PHP-FPM сам, fastcgi_pass_request_headers включён по умолчанию. Ищите причину в форме, cookie и конфиге Laravel.

  • Запуск php artisan optimize через sudo после смены владельца bootstrap/cache.

    Команда оставит файлы root, и PHP-FPM не сможет их перезаписать. Запускайте её от владельца проекта, а права на storage и bootstrap/cache возвращайте через sudo chown -R $USER:www-data storage bootstrap/cache.

  • Отключение проверки CSRF целиком через исключение всех маршрутов.

    Исключайте только те адреса, которым токен действительно не нужен, например вебхуки: $middleware->validateCsrfTokens(except: ['stripe/*']) в bootstrap/app.php.

Deploykin

Как это делается в Deploykin

В Deploykin у каждого сайта свой системный пользователь и пул PHP-FPM, а команды в каталоге сайта выполняются от этого пользователя, поэтому права на storage и bootstrap/cache не расходятся. .env правится в панели, laravel.log читается там же, а об ошибке деплоя приходит оповещение.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Почему 419 появляется только у части пользователей?

У них не сохраняется cookie сессии: другой домен в SESSION_DOMAIN, вход по HTTP при SESSION_SECURE_COOKIE=true или браузер блокирует cookie. Проверьте cookie в браузере на проблемном устройстве.

Виноват ли nginx в ошибке 419?

Нет. nginx передаёт Cookie и X-CSRF-TOKEN в PHP-FPM сам, причина в приложении: нет токена в форме, не сохраняется сессия или устарел кэш конфига.

Что делать после правки.env?

Выполните php artisan optimize от владельца проекта. До этого Laravel читает старые значения из кэша конфига.

Где искать подробности ошибки?

В storage/logs/laravel.log. При APP_DEBUG=false в браузере видна только общая страница, а подробности пишутся в лог.

Ещё по теме

Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.