Laravel请求验证失败重定向至其他路由问题排查与解决

原因 #

Laravel的表单请求验证默认适配传统Web表单提交场景：当验证失败时，框架会自动重定向到同前缀的GET路由（也就是你配置的category前缀下的get_categories接口），同时把验证错误存入session。这种行为的触发条件是框架判定当前为普通Web请求，而非API接口请求。

当UpdateCategoryRequest包含exists:categories,id规则时，传入不存在的ID会直接触发验证失败，触发框架默认的重定向逻辑；移除该规则后验证通过，请求自然进入update_category方法。

解决办法 #

• 让请求走API路由上下文
  把category相关路由放到routes/api.php中，或者在web.php的路由定义里添加api中间件：

  Route::prefix('category')->middleware('api')->group(function () {
      Route::get('/', [YourController::class, 'get_categories']);
      Route::post('/update', [YourController::class, 'update_category']);
  });
  

  API中间件组会自动配置为验证失败时返回JSON格式错误，而非重定向。

• 在自定义请求类中重写验证失败逻辑
  在UpdateCategoryRequest里重写failedValidation方法，强制返回自定义JSON错误：

  use Illuminate\Contracts\Validation\Validator;
  use Illuminate\Http\Exceptions\HttpResponseException;
  
  protected function failedValidation(Validator $validator)
  {
      // 检查是否是ID不存在的错误
      if ($validator->errors()->has('id')) {
          throw new HttpResponseException(response()->json([
              'message' => 'Category not found.'
          ], 404));
      }
      // 其他验证错误的默认处理
      throw new HttpResponseException(response()->json([
          'message' => 'Validation failed.',
          'errors' => $validator->errors()
      ], 422));
  }
  

• 使用路由模型绑定替代exists验证
  修改路由定义，把ID参数替换为模型绑定：

  Route::prefix('category')->group(function () {
      Route::get('/', [YourController::class, 'get_categories']);
      // 把/update改成/update/{category}，直接绑定Category模型
      Route::post('/update/{category}', [YourController::class, 'update_category']);
  });
  

  然后在控制器方法中直接注入模型：

  public function update_category(UpdateCategoryRequest $request, \App\Models\Category $category)
  {
      // 只有当Category存在时才会进入此方法，不存在则Laravel自动返回404 JSON响应
      // 编写你的更新逻辑
  }
  

  这种方式更符合Laravel的最佳实践，无需手动写exists验证。

• 前端请求添加Accept: application/json请求头
  如果是前端发起请求，在请求头里加上Accept: application/json，Laravel会识别为API请求，验证失败时自动返回JSON错误，而非重定向。

内容的提问来源于stack exchange，提问作者DCYılmaz