ThinkPHP 6 推荐直接使用 json() 方法返回 JSON，它自动设置 Content-Type、处理中文编码与特殊字符转义，并默认启用 JSON_UNESCAPED_UNICODE；TP5.1 需显式传参启用该选项，且须注意中间件覆盖响应头、BOM 及提前输出等问题。
ThinkPHP 6 用 json() 返回 JSON 最稳妥
直接调用 json() 方法是 ThinkPHP 6 输出标准 JSON 的推荐方式，它自动设置 Content-Type: application/json、处理中文编码、转义特殊字符，并兼容 JSON_UNESCAPED_UNICODE —— 不用手动 header() 或 echo json_encode()。
常见错误：有人在控制器里写 echo json_encode($data); die;，结果响应头没设对，前端拿不到 responseType: 'json' 的解析支持，甚至被浏览器当文本下载。
-
json()内部已启用JSON_UNESCAPED_UNICODE，中文不会变成u4f60 - 传入数组或对象都行，但不能传资源（如
mysqli_result），否则报错TypeError: json_encode() expects parameter 1 to be array or object - 如果数据含
DateTime对象，默认会转成字符串；需要自定义格式，得先用format('Y-m-d H:i:s')处理
return json(['code' => 200, 'msg' => '成功', 'data' => $list]);
ThinkPHP 5.1 怎么安全返回 JSON？别用 ajaxReturn()
ajaxReturn() 是 TP5.0 的遗留方法，TP5.1 已废弃，继续用会触发 Method not found: think\Response::ajaxReturn 错误。正确做法是统一走 json() 或手动构造 Response 实例。
注意兼容性陷阱：TP5.1 的 json() 默认不带 JSON_UNESCAPED_UNICODE，中文会被转义。必须显式传第二个参数：
立即学习“PHP免费学习笔记（深入）”；
- 写法：
return json($data, 200, [], ['json_encode_param' => JSON_UNESCAPED_UNICODE]); - 漏掉第三个空数组（
[]）会报错Array to string conversion，因为第三个参数是 header 数组，不能为空但可为空数组 - 如果用了
output配置项（如'json_encode_param' => JSON_PRETTY_PRINT），会影响接口性能，线上环境禁用
接口返回 JSON 时，Content-Type 被覆盖怎么办？
有些中间件（比如日志记录、跨域处理）或全局 header() 调用会覆盖 json() 自带的 Content-Type，导致前端收到 text/html 响应头，fetch().json() 直接抛错 Unexpected token。
排查和修复要点：
- 在控制器末尾加
dump(response()->getHeader('Content-Type'));看实际发出的头 - 检查是否在
app/middleware.php或中间件类里写了header('Content-Type: text/html')类似代码 - 跨域中间件中，不要用
header('Access-Control-Allow-Origin: *')混合写法，改用 ThinkPHP 原生的allowCrossDomain()方法，它能与json()兼容
返回 JSON 出现乱码或空白页？重点查这三处
不是代码问题，而是环境或输出缓冲干扰。典型现象：接口返回空响应体，或中文变问号，或 Chrome Network 面板显示 (failed) net::ERR_CONTENT_LENGTH_MISMATCH。
- 检查是否有
echo、var_dump()、print_r()等调试语句残留在控制器、模型或公共函数里 —— 任何提前输出都会破坏 JSON 结构 - 确认文件保存为
UTF-8 无 BOM格式，BOM 字节会卡在响应开头，导致json_decode()失败 - TP6 中启用了
debug模式时，异常页面会拦截正常 JSON 返回；上线务必关掉app_debug配置，别只靠APP_DEBUG=false环境变量，还要检查config/app.php里是否硬编码了'app_debug' => true
JSON 接口最脆弱的地方不在逻辑，而在“看不见的输出”——一个空格、一个 BOM、一次忘记删的 dd()，都能让整个响应失效。
