Yii2表单验证失败需返回标准JSON响应:手动验证后设response->format为JSON、setStatusCode(400),再return结构化数组;或抛BadRequestHttpException交由自定义errorAction统一处理,并配置JsonParser支持JSON请求解析。

Yii2 表单验证失败时默认返回 HTML 错误页(状态码 200),不是 JSON,也不带 400 状态码。要让验证失败返回标准 JSON 响应(如 {"code":400,"message":"验证失败","errors":{...}})并设对 HTTP 状态码,关键不在验证逻辑本身,而在如何接管验证失败后的响应流程。
验证失败后别走默认渲染,改用 JSON 响应
Yii2 的 Model::validate() 只做校验、不触发响应。真正决定返回什么的是控制器怎么处理结果:
- 如果用
$model->load()+$model->validate()手动验证,验证失败时不能直接return $this->render(...),而应主动返回 JSON 数组,并提前设好格式 - 必须在
return前执行:\Yii::$app->response->format = \yii\web\Response::FORMAT_JSON; - 然后直接
return ['code' => 400, 'message' => '参数验证失败', 'errors' => $model->getErrors()]; - 这样框架会自动序列化、设
Content-Type: application/json,且状态码保持 200 ——但你需要手动设 400:在 return 前加\Yii::$app->response->setStatusCode(400);
避免 setStatusCode 失效的实操要点
状态码设不上去,90% 是因为输出已开始或时机不对:
- 确保
setStatusCode(400)和response->format = JSON都写在return之前,且不能在render()、echo、var_dump()之后调用 - 检查有没有调试代码(比如日志里写了
Yii::info()但没关掉)、调试工具条、或中间件提前输出了内容 - 如果用了
beforeAction()统一设 format,记得它对所有 action 生效;验证失败时也要确保 status code 在同一作用域内设置,不要被后续逻辑覆盖
统一错误响应:推荐用自定义 errorAction
手动判断每个验证分支太散,更适合的做法是让验证失败也抛异常,交由全局错误处理器统一 JSON 化:
- 验证失败时不 return,而是
throw new \yii\web\BadRequestHttpException('参数错误', 400); - 在
config/web.php中配置 error handler:'errorHandler' => ['errorAction' => 'site/json-error'] - 新建
SiteController::actionJsonError(),里面设\Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;,再从\Yii::$app->errorHandler->exception提取信息,组装成结构化 JSON 并 return - 这样所有异常(包括验证失败抛出的)都走同一出口,状态码、格式、字段名完全可控
前端发的是 JSON,后端也要按 JSON 解析和响应
表单数据如果是前端用 fetch 发的 application/json,还需两步配套:
- 在配置中启用 JSON 请求解析:
'parsers' => ['application/json' => 'yii\web\JsonParser'],否则$request->post()拿不到数据 - 确保控制器里用
$request->getBodyParams()或$model->load($request->getBodyParams(), '')加载数据,而不是依赖$_POST - 验证失败返回 JSON 后,前端 fetch 才能正确读取
response.json(),不会因 Content-Type 不匹配而报错


















