ThinkPHP6.0如何发送JSON数据_ThinkPHP6.0接口返回【API】-ThinkPHP-PHP中文网

thinkphp6.0返回json必须用json()函数，因其返回json响应实例并自动设置content-type；直接return数组会触发模板渲染或类型错误。

thinkphp6.0如何发送json数据_thinkphp6.0接口返回【api】

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，大概率是这三处被忽略：

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

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