ThinkPHP 5.1 中实现 AJAX 返回 JSON 应使用 json() 方法直接 return，自动设置 Content-Type 和 UTF-8 编码；禁用 echo/dump，避免 headers 已发送；前端需设 dataType: 'json' 并检查响应头。
在 ThinkPHP 5.1 中实现 AJAX 返回 JSON，核心是确保控制器方法正确输出 JSON 格式数据，并设置合适的响应头。关键点在于：不使用 echo 或 dump()，而是用框架内置的 JSON 输出方式，避免中文乱码、格式错误或 headers 已发送等问题。
使用 json() 方法直接返回（推荐）
ThinkPHP 5.1 提供了便捷的 json() 助手方法，它会自动设置 Content-Type: application/json，并处理数组/对象序列化和中文 UTF-8 编码。
- 控制器中直接 return
json($data)，无需额外 echo 或 exit -
$data可以是数组、对象，支持嵌套，框架内部调用json_encode()并启用JSON_UNESCAPED_UNICODE - 示例：
use think\Controller;
class User extends Controller
{
public function getInfo()
{
$user = ['id' => 1, 'name' => '张三', 'email' => 'zhangsan@example.com'];
return json($user); // 自动输出 JSON 并终止后续执行
}
}
手动调用 Response 类（更灵活）
当需要自定义状态码、响应头或复用 Response 实例时，可用 response() 辅助函数或依赖注入。
- 写法一（辅助函数）：
return response($data, 200, [], 'json'); - 写法二（链式调用）：
return json($data)->code(200)->header(['X-App' => 'TP5']); - 注意：不要在 return 前调用
echo、var_dump或任何输出，否则会导致 headers already sent 错误
前端 AJAX 调用注意事项
确保前端请求头和接收逻辑匹配服务端输出：
立即学习“PHP免费学习笔记（深入）”；
- 推荐使用
contentType: 'application/x-www-form-urlencoded'（默认表单提交）或contentType: 'application/json'（需手动JSON.stringify()） - 务必设置
dataType: 'json'，jQuery 会自动解析；原生 fetch 则需调用response.json() - 检查浏览器开发者工具 Network 面板中的 Response 和 Headers，确认 status 200 且 Content-Type 是
application/json
常见问题排查
如果返回的是 HTML 或空白页，大概率是以下原因：
- 控制器方法末尾遗漏
return，导致框架继续执行模板渲染 - 代码中有 warning/notice 输出（如未定义变量），破坏了 JSON 结构 —— 开发环境建议开启
error_reporting(0)或关闭 display_errors - UTF-8 BOM 头存在（尤其 Windows 编辑器保存时），会在 JSON 前插入不可见字符，造成解析失败
- 使用了
exit(json_encode(...))：绕过框架响应机制，丢失 header 设置，且无法被中间件拦截
