PHP问题解决：处理“Headers already sent”错误

在PHP开发中，我们经常会遇到一个常见的错误提示：“Cannot modify header information – headers already sent”。这个错误通常发生在你试图使用 header() 函数设置HTTP头（例如重定向或设置Cookie）时，但输出已经在脚本中提前发送了。

这篇文章将帮助你快速定位并解决这个问题。

一、错误原因

HTTP头信息必须在页面内容（HTML、空格、换行等）发送之前发送。一旦有内容被输出，PHP 就会认为 HTTP 头信息已经发送完毕，之后调用 header() 函数就会触发错误。

以下是常见的几种导致“Headers already sent”错误的原因：

1. PHP标签前有空格或换行符

  <?php  // 前面有空格
header("Location: index.php");

2. 使用了 echo、print 或 HTML 输出在 header() 之前

echo "Hello";
header("Location: index.php"); // 错误

3. 使用 include/require 加载的文件中包含空白或输出

比如你引入的配置文件或模板文件，在 <?php 标签前或后存在空白或错误输出。

4. UTF-8 BOM 文件头问题

有时候你保存的 PHP 文件是 UTF-8 with BOM 编码，会在文件开头插入隐藏的 BOM 字符（\xEF\xBB\xBF），这也会造成输出提前。

二、解决方法

✅ 方法一：检查输出开始的位置

确保你在调用 header()、setcookie()、session_start() 等函数之前，没有任何输出。包括：

• 没有 echo、print、var_dump
• 没有 HTML 标签直接输出
• 没有空白或空行

✅ 方法二：移除 BOM 头

使用支持查看和修改编码的编辑器（如 VSCode、Notepad++、Sublime Text）打开你的 PHP 文件，另存为 UTF-8 无 BOM 格式。

VSCode 示例：

1. 打开文件
2. 点击右下角显示的编码（如 UTF-8 with BOM）
3. 选择“Save with Encoding”
4. 选择 UTF-8

✅ 方法三：使用输出缓冲

使用 ob_start() 在脚本开始处开启输出缓冲，可以延迟输出，确保 header() 能够正常调用。

<?php
ob_start();
// 其他逻辑代码
echo "Hello World";
header("Location: index.php");
ob_end_flush();

⚠️ 注意：输出缓冲虽然可以解决此问题，但不应滥用，因为它会增加内存开销。

✅ 方法四：检查引入文件

如果你的错误发生在引入了其他文件后，可以检查这些文件是否含有输出内容：

<?php
// config.php
?>
Some content <!-- 这里会导致问题 -->
<?php

// index.php
include 'config.php';
header("Location: home.php"); // 错误触发

解决方案是确保引入的文件只有 PHP 代码，并且关闭 ?> 标签（建议 PHP 文件只写 PHP 代码时省略 ?>）。

三、排查技巧

1. 查看错误提示的文件和行号

PHP 通常会提示你“headers already sent by ...”并指出是哪个文件哪一行输出了内容。比如：

Warning: Cannot modify header information - headers already sent by (output started at /path/to/file.php:10)

前往该文件第10行查看是否有输出或空白。

2. 使用 headers_sent() 函数检查

在调用 header() 前使用该函数检查头是否已发送：

if (!headers_sent()) {
    header("Location: index.php");
    exit;
} else {
    echo "Headers already sent.";
}

四、最佳实践

五、总结

“Headers already sent” 是 PHP 中非常常见但容易解决的问题。通过以下几点可以有效避免：

• 保持 header() 调用之前无任何输出
• 检查文件编码（避免 BOM）
• 使用输出缓冲控制输出流程
• 检查引入的外部文件内容

希望这篇原创文章能帮你彻底解决这个问题！