最稳妥的做法是统一显式调用json($data)。TP5.1不自动序列化数组，直接return数组会输出“Array”文本；TP6仅在Accept头为application/json且无干扰操作时才自动转JSON，跨版本混用易出错。
ThinkPHP 5.1 的 Response 不自动序列化数组，TP6 在特定条件下可自动转 JSON，但跨版本混用极易出错——最稳妥的做法是统一显式调用 json($data)。
TP5.1 返回数组会直接输出 "Array" 文本
这不是 bug，而是设计上把「响应内容」和「响应格式」拆开了：return ['code' => 0, 'data' => []] 在 TP5.1 中等价于 echo 'Array'，浏览器看到的是纯文本，不是 JSON。常见错误现象：前端 fetch().json() 报 Unexpected token A in JSON。
- 必须显式写
return json($data)，它会自动设Content-Type: application/json并调用json_encode - 若自己拼
echo json_encode($data)，务必补header('Content-Type: application/json')，否则前端解析失败 -
Response::create($data, 'json')也能用，但第二个参数是类型名（'json'），不是 MIME 字符串，参数顺序容易错
TP6 的自动 JSON 转换有严格前提
TP6 确实支持控制器方法直接 return $array 自动转 JSON，但仅限以下两个条件同时满足：
- 请求头带
Accept: application/json（Postman 默认不带，axios 默认带） - 没显式调用过
response()->xxx()或Response::create()干扰默认流程
一旦中间件里写了 dump()、日志驱动悄悄输出 HTML 注释，或路由里提前调了 response()->view()，自动转换就失效，退化成 TP5.1 行为。返回 Collection 或模型实例时会先 toArray() 再 encode；但返回 Closure 或 resource 会直接抛 InvalidArgumentException。
立即学习“PHP免费学习笔记（深入）”；
header 冲突和缓冲区提前输出是共通雷区
无论 TP5.1 还是 TP6，只要在响应发送前有任何输出（echo、var_dump、文件末尾多一个空格），都会触发 headers already sent 错误，JSON 格式全乱。
- TP5.1 常见于中间件调试没删干净的
dump() - TP6 更隐蔽：某些日志驱动在 CLI 下不生效，切到 FPM 后可能偷偷输出 HTML 注释
- 快速排查法：控制器开头加
if (headers_sent($file, $line)) { die("header sent at $file:$line"); }
跨版本兼容写法必须绕开所有自动推断
想一份代码在 TP5.1 和 TP6 都稳定输出 JSON，就别依赖任何“自动识别”。统一走 json() 显式声明是最小安全交集：
- TP5.1：
return json($data)->header(['Cache-Control' => 'no-cache']) - TP6：
return json($data)->withHeader('X-TP-Version', '6')（注意 TP6 是链式withHeader()，TP5.1 是header()） - 禁用
Response::create($data, 'json')跨版本混用——TP5.1 返回对象，TP6 返回think\Response实例，类型不一致会导致 IDE 报错或运行时异常
真正容易被忽略的是：TP6 的自动转换只作用于控制器方法返回值，对中间件 handle() 返回的 Response 对象完全无效；而 TP5.1 根本没有这个机制，所有中间件输出都得自己手动封装 json()。
