讲师中心 微信公众号
AI工具推荐 视频效率加速

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

浅明大大_1954

浅明大大_1954

发布时间:2026-08-20 16:09:24

|

205人浏览过

|

来源于php中文网

原创

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 不匹配而报错

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

相关专题

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

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

504

2025.11.26

json数据格式
json数据格式

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

1955

2023.08.07

json是什么
json是什么

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

2622

2023.08.23

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

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

916

2023.10.13

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

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

2939

2025.09.10

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

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

181

2026.03.30

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

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

2750

2025.09.04

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

0

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

0

2026.09.22

热门下载

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

精品课程

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

共101课时 | 20.5万人学习

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

共39课时 | 4.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn