接口返回空白的主因是输出被提前终止，常见于php文件含bom、中间件漏return、echo/var_dump等提前输出或重写规则错误。
接口返回空白，不是没数据，是响应体为空、HTTP状态码可能是200但body为空字符串——大概率是输出被提前终止、编码污染或中间件中断了请求流。
检查 PHP 文件是否 UTF-8 无 BOM
哪怕一个文件开头带 BOM（EF BB BF），就会在 json() 或 view() 前产生不可见输出，导致 header 已发送，后续 JSON 序列化失败并静默丢弃响应体。
- 用 VS Code 或 PhpStorm 打开
app/controller/、route/app.php、config/app.php等所有 PHP 文件，右下角确认编码为「UTF-8 without BOM」，不是「UTF-8 with BOM」 - 特别注意：新建的控制器文件、复制粘贴来的路由配置、甚至
.env文件里中文注释都可能引入 BOM - 命令行快速检测：
head -n1 your_file.php | hexdump -C | head -1，若输出含ef bb bf就是 BOM
确认中间件是否漏掉 return $next($request)
ThinkPHP 中间件必须显式返回 $next($request)，否则请求流中断，控制器不执行，响应为空。
- 检查自定义中间件（如统计、鉴权、日志类）的
handle()方法末尾是否有return $next($request); - 若用了
exit、die、echo后没 return，或条件分支里只在 if 写了 return、else 没写，都会导致空响应 - 临时加一行日志：
file_put_contents('runtime/log/mw.log', 'middleware hit', FILE_APPEND);，访问接口看是否写入——没写入说明中间件根本没跑；写了但没响应，大概率是漏 return
排查 echo / var_dump / print_r 提前输出
任何非响应机制的输出（echo、var_dump、print_r、未捕获的 Notice）都会触发 headers already sent，使框架无法设置 Content-Type 和输出 JSON/HTML。
- 全局搜索项目中所有
echo、var_dump、print_r，尤其是控制器方法开头、中间件、配置文件里 - 检查是否访问了未定义数组键，例如
$data['user_id']而$data是空数组，会触发 Notice 并输出到响应体 - 打开
.env中的APP_DEBUG=true，让错误直接显示在页面上；若仍空白，说明错误发生在更早阶段（如自动加载、中间件入口）
验证 public/index.php 是否被正确访问
TP6 默认入口是 public/index.php，Web 服务器若没重写规则或路径配错，会直接运行根目录下的 index.php（不存在），导致 404 或空白。
- 确认浏览器 URL 是
http://your-domain.com/api/test（无index.php），且 Web 服务已启用 rewrite（Apache 开启 mod_rewrite，Nginx 配置try_files $uri $uri/ /index.php?$query_string;） - 手动访问
http://your-domain.com/public/index.php/api/test，如果能正常返回，说明是重写规则问题 - 检查
public/index.php文件是否存在、权限是否可读、内容是否被意外清空（常见于部署脚本误删）
真正难定位的空白，往往卡在「谁最先输出了东西」——BOM 是隐形的，Notice 是默认不显示的，中间件 return 是容易被忽略的语法点。别急着翻框架源码，先用 file_put_contents 打点，从 public/index.php 开始一路往下埋日志，比猜快得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
