ThinkPHP控制器返回JSON最标准方式是使用json()方法，自动设置响应头、处理UTF-8编码并兼容调试与中间件；需return调用，禁用ViewInit中间件防干扰，推荐封装统一响应函数，严禁手动echo+json_encode。

ThinkPHP控制器返回JSON数据最标准、最可靠的方式是使用框架内置的 json() 方法，它自动设置响应头、处理UTF-8编码，并兼容调试模式和中间件生命周期。

直接用 json() 辅助函数（推荐）

这是最常用也最安全的做法。注意必须 return，不能只调用：

• 在控制器方法中构造好数据数组，例如：$data = ['code' => 200, 'msg' => '成功', 'data' => ['id' => 1]];
• 执行 return json($data); —— 框架会自动设 Content-Type: application/json; charset=utf-8
• 如需显示原始中文（不转义为 \uXXXX），加选项：return json($data, 200, [], JSON_UNESCAPED_UNICODE);
• 要支持跨域，可链式添加响应头：return json($data)->header(['Access-Control-Allow-Origin' => '*']);

禁用 ViewInit 中间件防干扰

如果返回的是 HTML 或乱码，大概率是模板中间件把 JSON 当成视图变量处理了：

jm-jsjkxyjs02-zlm-405

使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。

下载

• 在路由定义中排除该中间件：->withoutMiddleware(\think\middleware\ViewInit::class)
• 或全局禁用：在 config/app.php 中确认 'view_init' => false，或移除相关中间件配置
• 纯 API 项目建议统一关闭视图初始化，避免意外渲染

封装统一响应方法提升一致性

为所有接口保持相同结构（如 {code, msg, data}），建议封装复用逻辑：

立即学习“PHP免费学习笔记（深入）”；

• 在 app/common.php 中定义助手函数：
  function api_success($data = null, $msg = '操作成功') { return json(['code' => 200, 'msg' => $msg, 'data' => $data]); }
• 或在基类控制器中写方法：
  protected function success($data = null) { return json(['code' => 200, 'msg' => '成功', 'data' => $data]); }
• 子控制器继承后直接调用：return $this->success($user);

避免手动 echo + json_encode()

绕过框架响应机制会导致问题：

• 不设 Content-Type，前端可能解析失败
• 跳过中间件、事件、日志和调试追踪
• 中文被转义、资源类型静默失败、无法链式追加 header
• 正确做法始终走 return json(...)，不要用 echo json_encode(...) + exit