Laravel 8：POST方式用Fetch发送Ajax数据到控制器无响应问题

1. 校验CSRF令牌（最常见问题） #

Laravel默认会验证POST请求的CSRF令牌，缺失或错误都会导致请求被拦截：

• 页面头部必须包含CSRF元标签：

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

• Ajax请求中通过请求头携带令牌：

  // jQuery示例
  $.ajax({
      url: '/your-post-endpoint',
      method: 'POST',
      headers: {
          'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
      },
      data: {
          username: 'test',
          email: 'test@example.com'
      },
      success: res => console.log(res)
  });
  

  也可以在表单数据中直接加入_token: $('meta[name="csrf-token"]').attr('content')。

2. 匹配请求头与数据格式 #

• 如果发送JSON格式数据，必须设置Content-Type: application/json，并将数据转为JSON字符串：

  $.ajax({
      url: '/your-post-endpoint',
      method: 'POST',
      headers: {
          'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content'),
          'Content-Type': 'application/json'
      },
      data: JSON.stringify({ username: 'test', email: 'test@example.com' }),
      success: res => console.log(res)
  });
  

  对应控制器获取方式：

  public function handleRequest(Request $request)
  {
      $username = $request->input('username');
      // 或获取全部JSON数据
      $allData = $request->json()->all();
      return response()->json(['received' => $allData]);
  }
  

• 如果是表单编码格式（默认application/x-www-form-urlencoded），直接传递对象即可，控制器用$request->input('字段名')获取。

3. 控制器正确获取数据 #

禁止直接使用$_POST全局变量，必须通过Laravel的请求对象获取：

use Illuminate\Http\Request;

public function handlePost(Request $request)
{
    // 获取单个字段
    $email = $request->input('email');
    // 获取所有请求数据
    $allData = $request->all();
    // 校验字段（可选）
    $request->validate([
        'email' => 'required|email'
    ]);
    return response()->json(['status' => 'success', 'data' => $allData]);
}

4. 确认路由定义正确 #

确保路由为POST类型，且指向对应控制器方法：

// routes/web.php
Route::post('/your-post-endpoint', [YourController::class, 'handlePost']);

• 如果是API路由（routes/api.php），默认已排除CSRF校验，但需注意路由前缀（默认/api）。

5. 排查中间件拦截 #

检查全局中间件或自定义中间件是否对POST请求做了额外过滤，比如参数清洗、权限拦截等。可以临时注释非必要中间件，测试请求是否正常。

6. 分析网络请求详情 #

打开浏览器开发者工具（F12）→ Network标签，定位到目标POST请求：

• 查看Headers：确认X-CSRF-TOKEN和Content-Type是否正确
• 查看Payload/Form Data：确认发送的参数是否存在
• 查看Response：如果有错误提示（比如CSRF不匹配），根据提示修复

内容的提问来源于stack exchange，提问作者Douglas Vicentini