Laravel版本升级后POST请求报错主因是CSRF校验、中间件签名变更及请求体解析机制变化：419错误源于VerifyCsrfToken拦截（含Sanctum自动激活场景），需在$except中配置'api/*'；Laravel 9+强制handle($request, Closure $next)签名，禁用额外位置参数；表单须@csrf+web中间件，JSON请求需application/json头。
Laravel 版本升级后 POST 请求报错，多数不是路由或语法写错，而是底层机制变化触发的隐性兼容问题。关键不在“怎么写 POST”，而在“POST 被谁拦了、按什么规则校验、参数怎么解析”。快速定位和兼容，盯住三个核心层：CSRF 验证、中间件签名、请求体解析。
先看是不是被 CSRF 拦了（最常见）
419 错误（Page Expired）本质是 TokenMismatchException，说明 VerifyCsrfToken 中间件拒绝了请求。
- 如果是浏览器发起的 API POST（比如用 fetch 调用
/api/login），即使你没加web中间件，也可能被 Sanctum 的EnsureFrontendRequestsAreStateful激活 session 和 CSRF 校验； - Laravel 9.23+ 支持通配符排除，直接在
app/Http/Middleware/VerifyCsrfToken.php的$except数组里加：protected $except = [ 'api/*', ];
- 别写
'api/'或'api'—— 前缀匹配只认str_starts_with()，必须带/*才能覆盖所有子路径。
再查中间件 handle 方法签名是否合规
Laravel 9+ 强制要求中间件 handle 方法第二个参数必须是 Closure $next，且不能有额外位置参数。
- 错误写法（Laravel 8.x 可跑，9+ 直接 TypeError）：
public function handle($request, $next, $role) { ... } - 正确写法（参数统一收口，动态值走构造函数或 route middleware 传参）：
public function __construct(private string $role) {} public function handle($request, Closure $next) { if (! $request->user()?->can($this->role)) { abort(403); } return $next($request); }注册时用
Route::middleware('can:edit-post')，框架会自动把edit-post解析为第三个参数$parameters。
最后确认 POST 参数有没有被正确解析request()->all() 返回空？不是丢了，是没被识别成表单或 JSON。
- 表单提交（HTML
<form>）：必须用@csrf+method="post"，且服务端路由需在web中间件组里； - HTTP 客户端调用（如
Http::post()）：
✓ 要发表单数据 → 用asForm()，不设Content-Type，不手动加Host头；
✓ 要发 JSON 数据 → 不用asForm()，改用body()+ 显式头：Http::withHeaders(['Accept' => 'application/json']) ->post('https://api.example.com/login', ['email' => 'a@b.c', 'password' => '123']);Laravel 默认从
php://input解析 JSON，前提是Content-Type: application/json（Http::post()会自动带上）。
不复杂但容易忽略
