ThinkPHP5中应使用json()方法返回JSON，它自动设置Content-Type、处理编码并终止执行；避免手动echo、提前输出、模板渲染及前端解析方式错误。
ThinkPHP5中用json()方法直接返回JSON
ThinkPHP5内置了json()响应方法，是返回JSON最简洁、最安全的方式。它会自动设置Content-Type: application/json头，并对数据做json_encode()处理，还支持中文不转义、JSON_UNESCAPED_UNICODE等选项。
常见错误是手动echo json_encode(...)后没exit，导致模板内容被追加输出，JSON结构被破坏；或者忘记设置header，前端收到text/html类型响应，response.json()解析失败。
正确写法示例如下：
public function getData()
{
$data = ['code' => 200, 'msg' => '操作成功', 'data' => ['id' => 1, 'name' => '张三']];
return json($data);
}
如果需要控制JSON编码选项（比如保留中文、处理浮点数精度），可传第二个参数：
立即学习“PHP免费学习笔记（深入）”；
return json($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
控制器返回JSON时必须终止后续执行
ThinkPHP5的json()本身已调用exit，但如果你在中间件、钩子或自定义逻辑里提前输出了内容（比如dump()、echo、var_dump()），会导致HTTP响应体开头混入HTML或空白字符，前端解析时抛出SyntaxError: Unexpected token。
排查这类问题的关键点：
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 检查是否在
json()前有调试语句未注释 - 确认没有开启
debug模式下的自动trace输出（app_debug = true时可能注入HTML） - 避免在
__construct()或initialize()中直接输出内容 - 使用
Response::create(..., 'json')时也要注意——它不会自动exit，需手动->send()->exit()
Ajax请求下关闭模板渲染和布局
即使返回了JSON，如果控制器方法末尾没显式返回响应对象，ThinkPHP5仍可能尝试渲染默认模板（尤其当方法没return任何值时），导致JSON被套进HTML里。典型现象是浏览器Network面板看到响应体开头是{"code":200...，但结尾多了一大段HTML。
确保以下任一条件成立：
- 控制器方法以
return json(...)明确结束（推荐） - 在方法开头调用
$this->view->engine->layout(false)禁用布局 - 在配置中全局关闭自动渲染：
'default_return_type' => 'json'（不建议，影响非AJAX接口）
另外，别在Ajax接口里调用$this->fetch()或$this->display()，这是模板渲染指令，与JSON返回互斥。
前端接收时注意Content-Type和dataType匹配
ThinkPHP5的json()已设好Content-Type: application/json，但前端jQuery若写dataType: 'json'，遇到空响应或格式错误会静默失败；原生fetch()则必须显式调用response.json()，否则拿不到解析后的对象。
容易忽略的坑：
- 后端返回
json(['code'=>0])，但前端用response.text()再JSON.parse()——多余且易错，应直接response.json() - 后端因异常未走到
json()，返回了500页面（HTML），前端仍按JSON解析，报错不直观 - 跨域场景下，若后端没配
Access-Control-Allow-Origin，浏览器根本不会把响应交给JS，控制台只显示CORS错误，而非JSON解析失败
调试时优先看Network面板的Response标签页，确认原始响应体是否为合法JSON、状态码是否为200、Content-Type是否正确——这些比前端代码更容易定位问题。
真正麻烦的不是怎么返回JSON，而是当返回失败时，错误被吞掉、日志没开、debug关着，最后在前端反复改dataType却找不到根源。
