如何处理PHP环境中出现的Header already sent错误_排查BOM头与输出缓冲配置-php教程-PHP中文网

bom头是php中“headers already sent”错误最隐蔽的元凶；它在文件开头插入ef bb bf三个不可见字节，被php视为实际输出，导致header()、setcookie()、session_start()失败。

如何处理php环境中出现的header already sent错误_排查bom头与输出缓冲配置

UTF-8 BOM是PHP中“Headers already sent”最隐蔽的元凶之一。它在文件开头插入EF BB BF三个不可见字节，PHP会把它当作实际输出，导致header()、setcookie()、session_start()全部失败。

检查方法很简单：用VS Code、PhpStorm或Notepad++打开PHP文件，查看右下角编码显示。如果写着“UTF-8 with BOM”，立刻转为“UTF-8 without BOM”并保存。

哪怕只是<?php 前多了一个空格、回车，或者?>后多了一行空行，都会触发该错误。PHP把它们全算作“已输出”。

实操建议：

打开文件，把光标移到第一列，按Home键后直接敲End——如果光标没跳到<?php 末尾，说明前面有隐藏字符
纯PHP文件（无HTML混排）建议省略?>闭合标签，彻底规避结尾换行问题
用cat -A filename.php（Linux/macOS）或Notepad++的“显示所有字符”功能，直观看到^M（回车）、^I（制表符）等

错误提示里写的行号常不准，尤其当文件被include或require时。真正输出可能来自被包含的配置文件、函数库甚至日志工具。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

在出错前加这段诊断代码：

if (headers_sent($file, $line)) {
    echo "Headers already sent in <code>$file</code> on line <code>$line</code>";
    exit;
}

它能精准告诉你哪一行、哪个文件先动了输出——比看报错日志快得多。

这个函数返回true就代表HTTP头已发出，不能再调用header()
注意：var_dump()、print_r()、error_log()（若配置了log_errors = On且error_log指向stdout）也可能触发输出

ob_start()确实能让header()“看起来”更宽容，但它掩盖了根本问题，还可能带来副作用。

使用前必须确认：

必须放在脚本最顶部，<?php 之后立即执行，不能有任何前置语句或空行
避免多次嵌套调用ob_start()，否则ob_end_flush()可能只清最内层缓冲
开启zlib.output_compression = On或output_handler = ob_gzhandler时，ob_start()行为会异常，优先关掉这两个配置
云函数（如AWS Lambda + Bref）不支持传统SAPI输出缓冲，ob_start()无效