Laravel自定义验证器校验失败时返回HTML页面而非JSON问题求助

这个问题的核心在于路由所在的中间件组差异，Laravel对web和api路由的异常响应逻辑设计是完全不同的：

• 你把API路由配置在了web.php里，这里的路由默认绑定web中间件组——这个组是为浏览器端请求设计的，当验证失败时，框架会默认返回HTML格式的错误页面（比如重定向回表单页），哪怕你请求头设置了Content-Type: application/json也不会改变这个默认行为。
• 而api.php里的路由会自动使用api中间件组，这个组专门针对API场景优化，验证失败时会自动返回JSON格式的错误响应。

快速解决方案：将路由迁移到api.php #

这是最贴合Laravel设计规范的做法，只需要把你的路由从web.php移到api.php即可：

// api.php
use App\Http\Controllers\TaskController;

Route::post('/v1/tasks', [TaskController::class, 'store']);
// 或者按需使用resource路由
Route::resource('/v1/tasks', TaskController::class)->only(['store']);

注意：api.php里的路由默认会被加上/api前缀（框架在RouteServiceProvider中默认配置），所以你的请求地址依然是POST /api/v1/tasks，和之前的请求路径完全一致，无需修改请求逻辑。

备选方案：在请求类中强制返回JSON错误 #

如果因为特殊需求必须把路由留在web.php里，可以在StoreTaskRequest中重写failedValidation方法，强制验证失败时返回JSON响应：

<?php
namespace App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Contracts\Validation\Validator;
use Illuminate\Http\Exceptions\HttpResponseException;

class StoreTaskRequest extends FormRequest {
    // 保留你原有的authorize()、rules()、messages()方法

    protected function failedValidation(Validator $validator)
    {
        throw new HttpResponseException(
            response()->json(['errors' => $validator->errors()], 422)
        );
    }
}

这样无论路由在哪个文件中，只要触发验证失败，都会返回标准422状态码的JSON格式错误信息。

补充说明：你测试用的请求参数缺少project_id字段，这正是触发验证失败的原因，用上述方案修复后，就能收到包含project_id必填提示的JSON错误响应了。

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