echo会提前写入输出缓冲区，导致后续Response对象无法设置响应头而触发headers already sent错误；必须确保无任何前置输出（含空格、BOM、dump等），导出类响应需首行调用ob_end_clean()清理缓冲。
ThinkPHP 的 echo 会直接写入 PHP 输出缓冲区，一旦发生，后续的 Response 对象就无法再安全设置响应头（如 Content-Type、Content-Disposition），直接触发 headers already sent 错误，导致 JSON 乱码、下载失败、Excel 打不开等现象。
为什么 echo 之后 Response::create() 或 json() 就失效
Response 对象在真正发送前必须调用 header() 设置状态码和类型，而 PHP 规定：只要有任何输出（哪怕一个空格、换行、BOM 或 echo ''）到达输出缓冲区，header() 就会失败。
-
echo发生在 Response 构建之前 → 缓冲区已有内容 →header()调用静默失败 → 响应头缺失 → 浏览器按 text/html 解析 JSON，报Unexpected token - 框架内部的
json($data)本质是Response::create(...)->send()，同样依赖header()成功 - 即使你用
ob_start()手动开启缓冲，只要没在echo后立刻ob_end_clean()清掉，Response 仍会继承已污染的缓冲上下文
哪些地方容易偷偷 echo
不是只有你写的 echo 才危险，以下位置都可能提前输出：
- 控制器方法开头或结尾多了一个空格、UTF-8 BOM（尤其 Windows 编辑器保存时默认加）
- 中间件里写了
dump()、var_dump()或未注释的调试echo - 引入的配置文件末尾有空行或
?>后多出换行 - 日志驱动（如 trace）在 FPM 模式下输出 HTML 注释到响应体开头
- 模板文件被意外加载（比如
$this->fetch()没写 return，又没关调试）
如何快速定位是谁先 echo 的
在控制器入口加一行检查，能立刻暴露源头：
立即学习“PHP免费学习笔记（深入）”；
if (headers_sent($file, $line)) {
die("Headers already sent in {$file}:{$line}");
}
这个判断比 error_get_last() 更早、更准。它会在 Response 尝试发 header 前就中断，告诉你具体哪行哪个文件先动了输出缓冲区。
导出类响应（CSV/Excel）必须用 ob_end_clean()
导出场景对前置输出最敏感：Excel 文件开头多一个空格，就会让 Excel 弹“格式不匹配”；CSV 缺少 BOM，Windows 版 Excel 就当 GBK 解析中文。
- 别用
ob_flush()或ob_clean()—— 前者只是刷缓冲不清理，后者不清除已发送内容 - 必须用
ob_end_clean()，它会清空并关闭当前输出缓冲区，且不输出任何东西 - 该调用要放在导出逻辑第一行，且确保前面没有任何 include/require 加载了带输出的文件
- ThinkPHP 6 的
response()->download()内部已做类似处理，但前提是你的控制器方法里没任何echo干扰
真正难的不是记住该用哪个函数，而是理解「PHP 输出缓冲」和「HTTP 响应生命周期」是两层独立机制——Response 控制的是后者，而 echo 操作的是前者。一旦缓冲区被提前捅破，Response 就像想关门却发现门已经开着，怎么锁都无效。
