Alpine.js Ajax POST请求Laravel路由无数据接收问题排查

1. 缺失JSON请求头导致Laravel未解析数据 #

Laravel默认仅自动解析application/x-www-form-urlencoded和multipart/form-data格式的请求体到$request->all()。如果发送JSON数据，必须在请求头中指定Content-Type: application/json，否则Laravel不会处理JSON内容。

修正后的Alpine.js fetch请求示例：

async handleDataSend() {
  const payload = { /* 你的业务数据 */ };
  await fetch('/your-laravel-endpoint', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content
    },
    body: JSON.stringify(payload)
  });
}

• 务必携带X-CSRF-TOKEN，Laravel会校验POST请求的CSRF令牌，缺失会返回419状态码。

2. 手动解析请求体（兜底方案） #

若已设置正确请求头但仍无法获取数据，可在Laravel控制器中手动解析JSON：

$requestData = json_decode($request->getContent(), true);
dd($requestData);

3. 确认数据序列化正确性 #

确保使用JSON.stringify()将JavaScript对象转换为JSON字符串，直接传递对象会导致请求体内容为[object Object]，无法被正确解析。

4. 验证路由配置 #

确认Laravel路由为POST方法，且指向正确的控制器方法：

Route::post('/your-endpoint', [YourController::class, 'handleSubmit']);

内容的提问来源于stack exchange，提问作者Terre Porter