Yii2表单验证JSON返回失败状态码设置

浅明大大_1954

浅明大大_1954

2026-08-20

205人浏览

原创

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

yii2表单验证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% 是因为输出已开始或时机不对:

jm-jsjkxyjs02-pzl-803
jm-jsjkxyjs02-pzl-803

查询全球任意城市的实时天气和未来天气预报

下载
  • 确保 setStatusCode(400)response->format = JSON 都写在 return 之前,且不能在 render()echovar_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 不匹配而报错

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js json yii2 yii 状态码

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
PHP API接口开发与RESTful实践
PHP API接口开发与RESTful实践

本专题聚焦 PHP在API接口开发中的应用,系统讲解 RESTful 架构设计原则、路由处理、请求参数解析、JSON数据返回、身份验证(Token/JWT)、跨域处理以及接口调试与异常处理。通过实战案例(如用户管理系统、商品信息接口服务),帮助开发者掌握 PHP构建高效、可维护的RESTful API服务能力。

2025.11.26

504

16

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

1955

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

2622

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

916

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

2919

7

ThinkPHP表单验证与数据安全处理实战
ThinkPHP表单验证与数据安全处理实战

本专题聚焦 ThinkPHP 在表单处理中的验证与安全机制,系统讲解验证器使用、自定义规则、场景验证以及错误提示处理。内容涵盖 XSS 防护、SQL 注入防御、数据过滤与输入校验等关键安全措施。通过实际案例,帮助开发者构建安全可靠的数据处理流程。

2026.03.30

181

20

PHP Yii框架专题
PHP Yii框架专题

本专题专注于PHP主流框架Yii的应用,系统讲解MVC架构、路由机制、数据库操作、表单处理、安全验证与RESTful API 开发等核心内容。通过电商网站、后台管理系统与内容管理平台等实战项目,帮助学员快速掌握Yii框架的开发技巧与实战经验。

2025.09.04

2750

22

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

0

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 20.5万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.7万人学习