ThinkPHP 6 的 json() 返回 Response 对象而非直接输出，需 return json($data) 结尾；常见问题包括 Content-Type 错误、被模板中间件拦截，应禁用 ViewInit 中间件或使用全局 JSON 响应中间件统一处理。
ThinkPHP 6 返回 JSON 时 json 方法不生效？
不是方法错了，是默认没走 JSON 输出通道。ThinkPHP 6 的 json() 是一个“响应构造器”，它返回的是 think\Response 对象，但如果你直接 return json($data) 却没看到 JSON 响应头或格式，大概率是因为控制器方法没结束执行，或者被中间件/钩子拦截了输出。
常见错误现象：Content-Type: text/html、返回的是带 HTML 标签的字符串、浏览器直接下载文件。
- 确保控制器方法以
return json($data)结尾（不能只是调用，不 return） - 检查是否启用了模板自动渲染（
view中间件），它会强行把返回值当模板变量处理；关闭方式：在路由定义里加->withoutMiddleware(\think\middleware\ViewInit::class) - 如果用了
Response类手动实例化，别漏掉->send()—— 但更推荐直接return json(...)，框架会自动调用
ThinkPHP 5.1 和 6 的 json() 行为差异
5.1 的 json() 是助手函数，本质是 echo json_encode(...) + exit；6.x 改成返回 Response 对象，更利于中间件链和统一输出控制，但也意味着你不能再把它当“打印语句”随便放中间。
使用场景：API 接口、AJAX 回调、前后端分离项目。
立即学习“PHP免费学习笔记（深入）”；
- ThinkPHP 5.1：
json($data)立即输出并终止脚本，参数支持$options（如JSON_UNESCAPED_UNICODE），但无法链式设置 header - ThinkPHP 6：
json($data, $code = 200, $header = [], $options = JSON_UNESCAPED_UNICODE)，$header可追加Access-Control-Allow-Origin等跨域头，$options默认已含JSON_UNESCAPED_UNICODE - 兼容写法（跨版本）：统一用
return json($data)->header(['Access-Control-Allow-Origin' => '*'])，TP6 支持，TP5.1 不支持链式调用，需降级为return json($data)单独处理跨域
中文乱码、斜杠被转义、null 变空字符串？
这不是 ThinkPHP 的 bug，是 PHP json_encode() 的默认行为。TP 封装层没改底层逻辑，只是透传参数。
性能影响：开启 JSON_UNESCAPED_UNICODE（TP6 默认启用）可减少传输体积；但若后端依赖某些老 JS 解析器（不支持 Unicode），反而要关掉。
- 中文显示为 \uXXXX：确认
$options包含JSON_UNESCAPED_UNICODE，TP6 默认有，TP5.1 需显式传入 - URL 或 HTML 字符里斜杠变双斜杠（
\/）：这是JSON_UNESCAPED_SLASHES缺失，TP6 默认不开启，如需禁用转义，补上：json($data, 200, [], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) -
null字段变成空字符串：检查是否用了模型的toArray()+ 全局访问器（accessor），某些 accessor 会把 null 转成 ''；绕过方式：json($model->toOriginalArray())
想统一所有接口都 JSON 响应，但又不想每个方法都写 return json()
可以，但得接受两个限制：一是必须放弃模板渲染能力，二是部分系统级异常（如 404、500）仍走默认 HTML 响应，除非你重写异常处理器。
推荐做法是用全局响应中间件，而不是改核心类或基类 —— 后者在升级时容易冲突。
- 新建中间件
app/middleware/JsonResponse.php，handle()方法中判断请求是否为 API（比如路径含/api/或 header 有X-Requested-With: XMLHttpRequest） - 匹配成功后，对
$response做if (!$response instanceof Response && !is_string($response)) { $response = json($response); } - 注意：不要无条件包裹所有响应，否则
redirect()、view()会被强制 JSON 化，导致跳转失败
$response 可能是字符串、数组、视图对象，甚至 null。别图省事全塞进 json()，先 is_array() 或 is_object() 判定再处理。 
