ThinkPHP6.0返回JSON必须用json()函数，因其返回Json响应实例并自动设置Content-Type；直接return数组会触发模板渲染或类型错误。
ThinkPHP6.0 返回 JSON 数据，核心就一条：用 json() 函数返回数组，别直接 return $array —— 否则会触发模板渲染或抛出类型错误。
为什么 return $data 不行，而必须用 json($data)
TP6 的响应机制是“按返回值类型自动匹配 Response 子类”。直接 return 一个数组，框架无法识别为 JSON 响应，会尝试走视图渲染流程（比如找 index.html 模板），最终报错或输出乱码。
-
json($data)返回的是think\Response\Json实例，自带Content-Type: application/json; charset=utf-8头 - 不设状态码时默认 200；可传第二个参数指定，如
json($data, 400) - 若在中间件或控制器开头调用了
$request->withJson(true)（仅 TP6.1+ 支持），后续input()才能从 JSON body 中取值——但这和「返回 JSON」无关，别混淆
json() 和 response()->json() 有什么区别
TP6.0 官方只提供 json() 助手函数，response()->json() 是 Laravel 风格写法，在 ThinkPHP 中不存在、也不生效。
-
json($data)是最简方式，底层已封装好编码选项（如JSON_UNESCAPED_UNICODE） - 想手动控制编码参数？得用
response(json_encode($data, JSON_UNESCAPED_UNICODE), 200, ['Content-Type' => 'application/json; charset=utf-8'])，但没必要 - 别写
echo json_encode(...)+exit，会绕过框架生命周期，日志、钩子、中间件全失效
中文乱码、JSON 解析失败的三个常见原因
即使用了 json()，前端仍可能收到非法 JSON，大概率是这三处被忽略：
Wjs Uploading Video
下载
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
立即学习“PHP免费学习笔记（深入）”；
- PHP 文件本身带 BOM 头（尤其 Windows 编辑器保存时勾选了 UTF-8 with BOM）→ 导致响应体开头多出
（零宽无断空格），JSON 解析直接失败 - 控制器方法前/后有空白字符、空行或
echo/var_dump输出 → 破坏 JSON 结构完整性 - 模型中 JSON 字段未声明
protected $json = ['field_name'];，导致数据库查出的 JSON 字符串被当普通字符串返回，没自动解码成数组/对象
统一 JSON 响应格式的最佳实践
项目里每个接口都手写 json(['code'=>200, 'msg'=>'ok', 'data'=>$xxx]) 很容易漏字段、不一致。建议封装一个 Result 类：
namespace app\business\Result;
class Result
{
public static function success($data = null, $msg = 'success', $code = 200)
{
return json(['code' => $code, 'msg' => $msg, 'data' => $data], $code);
}
public static function error($code = 500, $msg = 'error', $data = null)
{
return json(['code' => $code, 'msg' => $msg, 'data' => $data], $code);
}
}
然后控制器里直接 return Result::success($user);。这样状态码、字段名、嵌套结构全可控，也方便后续加 trace_id、时间戳等通用字段。
真正麻烦的从来不是怎么返回 JSON，而是确保整个请求链路——从入口路由、中间件、控制器、模型到数据库字段定义——全部对齐 JSON 的语义：输入要解析、输出要编码、存储要声明、错误要拦截。漏掉任意一环，前端拿到的都可能是半截 JSON 或 HTML 错误页。
