Yii2默认不解析application/json请求体,需在config/web.php中为request组件配置'parsers'=>['application/json'=>'yii\web\JsonParser'],否则post()和getBodyParams()均为空。

Yii 框架接收 JSON POST 请求时返回空数据,不是前端没发对,也不是数据库没查到,而是 Yii 默认根本不解析 application/json 类型的请求体——它只认 application/x-www-form-urlencoded 和 multipart/form-data。不配解析器,Yii::$app->request->post() 和 $_POST 必然为空。
为什么 Yii::$app->request->post() 拿不到 JSON 数据
Web 服务器(Nginx/Apache)收到 Content-Type: application/json 的请求后,不会像表单那样自动拆解填充到 $_POST;它把整个 JSON 字符串原封不动塞进原始请求体(raw body)。Yii 默认只从 $_POST 读取,跳过了 raw body 解析这一步。
- 前端用
fetch或axios发送 JSON 时,Content-Type是application/json,这是标准行为,不用改 -
Yii::$app->request->getBodyParams()也为空?说明JsonParser没生效,不是代码写错,是配置缺位 - 错误现象:打印
Yii::$app->request->getRawBody()能看到完整 JSON 字符串,但post()、getBodyParams()全是空数组
必须在 config/web.php 里配 JsonParser
光写控制器逻辑没用,得让整个应用知道“遇到 JSON 就该解析”。配置位置固定,不能放在 controller 或 bootstrap 里。
- 打开
config/web.php,找到'components' => ['request' => [...]]这一段 - 在里面加
'parsers'键,值为关联数组:'application/json' => 'yii\web\JsonParser' - 如果前端可能发
text/json(少见但存在),可以额外加一行:'text/json' => 'yii\web\JsonParser' - 别漏掉已有的
'cookieValidationKey',否则 CSRF 验证会报错
'components' => [
'request' => [
'cookieValidationKey' => 'your-secret-key',
'parsers' => [
'application/json' => 'yii\web\JsonParser',
],
],
],
getBodyParams() 和 post() 的区别与选用
配好解析器后,两者都能拿到数据,但语义和行为不同。
-
Yii::$app->request->getBodyParams():只返回解析后的 JSON 数据(或空数组),不混入 GET 参数、文件等其他来源 -
Yii::$app->request->post():合并了$_POST+getBodyParams(),但仅当Content-Type匹配你配置的 parser 时才触发合并 - 推荐优先用
getBodyParams(),避免误读 GET 参数或历史遗留的$_POST干扰 - 如果请求同时带 URL 查询参数和 JSON Body,且都含同名字段,
post()会以后者覆盖前者;getBodyParams()则干净隔离
调试时别忘了检查 raw body 和解析结果
空结果集问题常卡在“以为配好了,其实没生效”,直接验证最省时间。
- 先打日志:
var_dump(Yii::$app->request->getRawBody());确认前端确实发了 JSON 字符串 - 再打:
var_dump(Yii::$app->request->getBodyParams());如果还是空,100% 是配置没加载或Content-Type不匹配 - 注意大小写:
application/json不能写成Application/JSON,Nginx/Apache 严格区分 - 开发环境开启
error_log或 Yii 日志,JsonParser解析失败时会在日志里报Invalid JSON data,而不是静默失败
真正容易被忽略的是:parser 配置必须在 request 组件初始化前完成,且只对匹配的 Content-Type 生效;哪怕多一个空格、少一个引号,整个解析链就断了,后续所有逻辑都拿不到数据。


















