ThinkPHP报表接口核心是控制器用return json($data)输出结构化JSON数据，字段名与前端ECharts严格对齐，禁止混入HTML、调试输出或模板渲染，确保Content-Type为application/json且无额外字符。
ThinkPHP 本身不提供“报表接口”这个现成功能，它只负责把结构化数据以 JSON 格式干净地吐出来；前端用 ECharts 或 Chart.js 渲染图表，才是完整链路。别在控制器里拼 HTML 表格或 echo 图片，那是反模式。
怎么写一个能被前端图表直接消费的报表接口
核心是：控制器返回 json()，字段名与前端 JS 取值严格对齐，且不能混入任何非 JSON 内容（比如调试 var_dump()、模板输出、echo）。
- TP6 推荐用
return json($data)，自动设置Content-Type: application/json - TP5.1 用
return $this->success('', $data)，但注意它默认包了一层code/msg，前端得适配，不如直接return json($data)简洁 - 数据格式建议扁平化，例如：
['xAxis' => ['1月','2月'], 'series' => [12000, 18500]]，避免嵌套过深导致 JS 解构出错 - 如果接口要支持分页/筛选参数（如
?year=2025&type=sales），记得在控制器里校验和过滤，别直接拼进 SQL
为什么返回 JSON 失败？常见解析错误原因
前端 fetch 拿到响应后报 Unexpected token < in JSON at position 0 或 JSON.parse: unexpected character，基本都是后端“多打了字”。
- 控制器里写了
echo 'debug';或var_dump($data);—— 必须删掉 - 模板文件（如
index.html）被意外加载，输出了 HTML 开头的<!DOCTYPE html>—— 确保该方法没调用$this->fetch() - TP6 的中间件里有日志记录或权限拦截，提前输出了内容（比如未登录跳转到 login 页面）—— 检查中间件逻辑是否在 JSON 接口路径上误触发
- PHP 错误提示开启（
display_errors=On），导致 Warning/Notice 被输出到响应体开头 —— 生产环境务必关掉
大数据量报表接口怎么避免超时或内存溢出
不是所有报表都适合一次查全。当 Db::table('sales')->select() 返回几万行时，PHP 很容易崩。
立即学习“PHP免费学习笔记（深入）”；
- 优先让数据库聚合：用
GROUP BY+SUM()/COUNT()，而不是 PHP 循环累加 - 加
set_time_limit(0)仅治标，不解决根本问题；应配合分页或时间范围限制（如只查最近 12 个月） - 用游标式分页（
WHERE id > ? ORDER BY id LIMIT 1000）替代LIMIT 10000,1000，避免深度分页性能骤降 - 导出类场景（如 Excel）可改用流式写入（
fputcsv()），但报表接口本身不该承担导出职责 —— 接口归接口，导出走另一个 URL
真正容易被忽略的是：同一个接口在 CLI（定时任务）和 Web（浏览器请求）下行为可能不同 —— 比如 session 初始化、路由缓存、数据库连接复用逻辑。测试报表接口，一定要用 curl 或 Postman 直接打 URL，别只靠页面 F5 刷新看效果。
