ThinkPHP怎样处理JSON请求数据_JSON数据处理方法【教程】

ThinkPHP 6 默认不解析 application/json 请求体，$request->input() 拿不到 JSON 字段——这不是你写错了，是框架默认行为。

为什么 $request->input('key') 总是 null？

因为 TP6 只对 application/x-www-form-urlencoded 和 multipart/form-data 自动解析请求体，application/json 被完全跳过。即使前端发的是 {"name":"张三"}，$request->input('name') 也返回 null 或空字符串。

• $request->getInputData() 能看到原始字符串，说明数据已到达 PHP 层
• $request->post() 同样为空，因为它底层依赖 input() 的解析结果
• Content-Type 必须严格为 application/json（不能带 ; charset=utf-8，某些版本会失败）

用 $request->json() 替代 input() 读顶层或嵌套字段

$request->json() 是 TP 封装的 JSON 解析入口，它自动读取 php://input、json_decode 并缓存结果，比手动 file_get_contents('php://input') 更安全高效。

• $request->json('name') → 返回 "张三"
• $request->json('tags.0') → 支持点号路径，取 "a"
• $request->json()（无参）→ 返回完整关联数组
• JSON 格式错误时返回 null，不会抛异常，需自行判断：if ($request->json() === null) { /* log or fallback */ }

$request->withJson(true) 和 $request->json(true) 怎么选？

这是触发 JSON 解析的关键动作，但版本差异大，不能混用：

• TP6.1+ 推荐在中间件或控制器开头调用 $request->withJson(true)，它会让后续所有 input()、param()、post() 都从已解析的 JSON 中取值（注意：只是“可用”，不是“自动生效”）
• TP6.0 不支持 withJson()，必须显式调用 $request->json(true)，它等价于执行一次解析并返回结果，但不改变 input() 行为
• $request->input('user.id', '', 'json') 这种写法无效——第三个参数只控制数据来源（get/post/param），不触发 JSON 解析

模型里存/取 JSON 字段容易踩的坑

数据库字段类型是 JSON 或 TEXT 都行，但 PHP 层处理逻辑完全不同：

• 写入前必须 json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)，否则中文乱码、斜杠被转义
• 读取时若想自动转成数组/对象，模型中必须声明 protected $json = ['config', 'extra'];，否则字段仍是字符串
• Db::table() 直接查绕过模型，$json 完全不生效；where('data->status', 1) 仅 MySQL 5.7+ 且字段类型为 JSON 才支持，TEXT 会 SQL 报错
• 别和 $withAttr 共用同一字段，否则可能重复 json_decode 导致返回 null

最常被忽略的一点：JSON 解析是否成功，不能只看有没有报错，得检查 json_last_error() 或直接 var_dump(gettype($data->field)) 确认它是 array/object 还是 string。