Laravel 12+Breeze+InertiaJS-React生产环境419页面过期问题求助

以下是针对你遇到的生产环境POST/PATCH/DELETE请求报419错误的排查和解决步骤：

1. 确保Inertia全局共享CSRF Token #

Breeze搭配Inertia时，默认应在HandleInertiaRequests中间件中共享CSRF Token，若生产环境未正确配置，会导致Token无法正常传递：

• 打开app/Http/Middleware/HandleInertiaRequests.php，在share方法中添加CSRF Token的共享：

public function share(Request $request): array
{
    return array_merge(parent::share($request), [
        'csrf_token' => csrf_token(),
        // 其他共享数据...
    ]);
}

• 在React组件中，通过usePage获取共享的Token，替代手动从meta标签获取（避免DOM加载顺序问题）：

import { usePage } from '@inertiajs/react';

const { props } = usePage();
const {data, setData, post, processing, errors, reset} = useForm({
    email: '',
    password: '',
    remember: false as boolean,
    _token: props.csrf_token,
});

2. 修正Session/Cookie生产环境配置 #

生产环境HTTPS下，Session/Cookie的配置错误是419的常见原因：

• 编辑.env文件，确保以下配置正确：

APP_URL=https://domain.com
SESSION_DOMAIN=.domain.com # 包含主域和子域（如www）
SESSION_SECURE_COOKIE=true # HTTPS必须设为true
SANCTUM_STATEFUL_DOMAINS=domain.com,www.domain.com # 允许的状态域

3. 完善Nginx请求头传递配置 #

Nginx若未正确传递请求头，会导致Laravel无法识别Session和CSRF Token：

• 修改Nginx配置，在location /块中添加请求头传递规则：

location / {
    try_files $uri $uri/ /index.php?$query_string;
    # 新增以下配置，确保请求头正确传递
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

• 同时确保fastcgi-php.conf中包含CONTENT_TYPE参数，POST请求需要该头来解析表单数据。

4. 刷新生产环境缓存 #

生产环境配置修改后，必须刷新缓存才能生效：

php artisan config:cache
php artisan route:cache
php artisan optimize:clear

5. 验证CSRF Meta标签存在性 #

检查生产环境页面源代码，确认<meta name="csrf-token" content="xxx">标签存在，若不存在，在resources/views/app.blade.php中添加：

<meta name="csrf-token" content="{{ csrf_token() }}">

内容的提问来源于stack exchange，提问作者Mehrdad Shirvan