ThinkPHP6.0如何发送JSON数据_ThinkPHP6.0接口返回【API】

ThinkPHP6.0 返回 JSON 数据，核心就一条：用 json() 函数返回数组，别直接 return $array——否则会触发模板渲染或抛出类型错误。先把这个关键点记住，剩下的一切都好办。

为什么 return $data 不行，而必须用 json($data)

TP6 的响应机制，说到底是“按返回值类型自动匹配 Response 子类”。直接 return 一个数组，框架根本识别不了它应该输出一份 JSON 响应，它只会照常走视图渲染流程——比如去满世界找 index.html 模板。结局要么是报错，要么是输出一团类似 HTML 的乱码。这又是为什么呢？因为框架默认把数组当成了需要渲染成模板的数据源。

• json($data) 返回的是 think\Response\Json 实例，它自带 Content-Type: application/json; charset=utf-8 头，前端收到就能直接解析。
• 不传状态码的话默认 200；当然也可以传第二个参数手动指定，比如 json($data, 400) 返回一个 400 响应。
• 顺便提一句，有些同学会在中间件或控制器开头调用 $request->withJson(true)（仅限于 TP6.1+），目的只是为了后续 input() 能从 JSON body 中取值——但这和“返回 JSON”是两个不同的事情，别搞混了。

json() 和 response()->json() 有什么区别

TP6.0 官方只提供了 json() 这个助手函数，response()->json() 完全是 Lara vel 风格，在 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()，前端仍可能告诉你 JSON 解析失败。这种时候，问题大概率出在下面三个容易被忽略的细节上：

• 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 错误页。