根本原因是输出缓冲未被正确控制；只要header()前有非缓冲输出（空格、BOM、echo等）即触发错误，而本地与线上环境因output_buffering和implicit_flush配置及UTF-8 BOM差异导致表现不一致。
PHP 中 header() 报 “headers already sent” 错误，根本原因不是 PHP 版本或写法过时，而是输出缓冲未被正确控制——只要在 header() 前有任何非缓冲输出（空格、BOM、echo、print、甚至文件末尾换行），就会触发该错误。
为什么 header 已发送错误在不同环境表现不一致？
本地开发常“不报错”，上线就崩，主要因为：
- 服务器开启
output_buffering = On（默认 4096 字节）时，PHP 会暂存输出，掩盖早期小量输出问题 -
php.ini中implicit_flush = Off会让缓冲行为更隐蔽 - UTF-8 BOM（尤其是 Windows 编辑器保存的 .php 文件）会在
前悄悄输出\xEF\xBB\xBF，肉眼不可见但直接破坏 header - include/require 的文件末尾有空行或空格，也会提前触发输出
最稳妥的兼容性写法：output\_buffering + header\_sent 检查
不依赖环境配置，主动管理缓冲层：
// 开启输出缓冲（放在所有可能输出之前，通常在入口文件第一行）
ob_start();
// 后续任意位置可安全调用 header()
if (!headers_sent()) {
header('Location: /login.php');
exit;
} else {
// 已发送则降级处理（如 JS 跳转或显示提示）
echo '';
exit;
}
-
ob_start()必须在任何输出前调用，包括空白字符；建议放在index.php顶部第一行 -
headers_sent()是唯一可靠判断依据，不要用ob_get_level()或ob_get_contents()替代 - 若已启用
output_buffering，ob_start()仍可嵌套，但需配对ob_end_flush()或ob_end_clean()
排查和修复常见隐性输出源
这类问题往往藏在你看不见的地方：
立即学习“PHP免费学习笔记（深入）”；
- 检查所有
include/require的文件：结尾是否有多余空行、空格或 UTF-8 BOM（用 VS Code 打开 → 右下角看编码，选 “Save without BOM”） - 确认
php.ini中short_open_tag = Off，避免被当作文本输出（尤其老项目混用） - 使用
error_log(headers_sent($file, $line))快速定位首次输出位置 - CLI 环境下
header()本就不生效，需用$_SERVER['argv']或环境变量区分运行模式
真正难的不是加 ob_start()，而是所有被 include 的配置文件、函数库、模板片段都必须零输出——一个被忽略的 ?>\n 就能让整个跳转逻辑失效。
