Laravel apiResource路由更新时出现405 Method Not Allowed异常

问题现象 #

• 使用PATCH方法访问.../api/majors/1更新数据，首次请求正常执行，GET请求能获取更新后的数据，但再次发起PATCH请求时返回405 Method Not Allowed. The PATCH method is not supported for route /. Supported methods: GET, HEAD.
• 更新不存在的ID（如.../api/majors/9）时，同样返回上述405错误

相关代码 #

routes/api.php：

Route::apiResource('/majors', MajorController::class);

MajorController.php的update方法：

public function update(int $id, UpdateMajorRequest $request) {
  $data = Major::findOrFail($id);
    
  try {
    $data->update($request->all());

    return response()->json("ok", 200);
  } catch (\Throwable $th) {
    return response()->json($th->getMessage(), 500);
  }
}

排查与解决步骤 #

1. 清除路由缓存

Laravel路由缓存可能导致路由规则不匹配，执行以下命令清除缓存：

php artisan route:clear

若之前生成过路由缓存，可重新生成：

php artisan route:cache

2. 检查请求URL正确性

确认Postman中第二次请求的URL完整，未遗漏ID参数（如误写成.../api/majors/而非.../api/majors/1）。405提示指向根路由/，大概率是请求路径未匹配到正确路由导致的。

3. 修复全局异常处理逻辑

findOrFail($id)找不到模型时会抛出ModelNotFoundException，若全局异常处理器（app/Exceptions/Handler.php）对该异常处理有误，会错误返回405而非404。修改异常处理逻辑：

// 在Handler.php的register方法中
use Illuminate\Database\Eloquent\ModelNotFoundException;

$this->renderable(function (ModelNotFoundException $e, $request) {
    if ($request->is('api/*')) {
        return response()->json([
            'message' => '资源不存在'
        ], 404);
    }
});

4. 验证API中间件组配置

确保routes/api.php使用的api中间件组未额外添加VerifyCsrfToken（API路由默认无需CSRF验证）。检查app/Http/Kernel.php中的配置：

protected $middlewareGroups = [
    'api' => [
        'throttle:api',
        \Illuminate\Routing\Middleware\SubstituteBindings::class,
    ],
];

5. 检查请求头设置

确认Postman中Content-Type为application/x-www-form-urlencoded，未开启自动重定向导致请求方法被篡改。

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