ThinkPHP 6 默认不解析 application/json 请求体，$request->input() 无法获取 JSON 字段；必须用 $request->json() 显式解析，或 TP6.1+ 调用 $request->withJson(true) 启用自动解析。
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 解析的关键动作，但版本差异大，不能混用：
立即学习“PHP免费学习笔记（深入）”；
- 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。
