PHP 8.3 页面跳转报 headers already sent 输出缓冲怎么开才生效

现象

登录校验通过后调用 header('Location: /home'),浏览器没有跳转,日志里出现 Warning: Cannot modify header information - headers already sent by (output started at /app/login.php:1)。页面顶部还能看到一小段空白,接口返回 200 而不是 302。

原因

HTTP 头必须先于任何输出发送。只要在 header 之前打印了一个空格、一个换行或 BOM,响应头就已经发出去了。常见来源是 <?php 之前有空行、文件带 UTF-8 BOM、include 的文件末尾多了换行、调试用的 var_dump 没删,以及 output_buffering 被关闭。

解决步骤

第一步,定位第一处输出。用 headers_sent 的三个参数拿到文件名和行号,再检查该文件开头是否有 BOM、空行或空白字符。

var_dump(headers_sent($file, $line), $file, $line);
grep -rl $'\xEF\xBB\xBF' /var/www/app

第二步,调整输出策略。确认文件以 <?php 开头且前面没有任何字符,纯 PHP 文件去掉结尾的 ?>;开启 output_buffering 让输出先进缓冲区,给 header 留出执行机会。

output_buffering = 4096
ob_start();
// 业务逻辑
header('Location: /home');
ob_end_flush();

第三步,分离逻辑与渲染。把跳转、设置 cookie 这类操作集中在控制器入口,视图渲染放到最后;必须在输出后跳转时改用前端 location.replace 或返回 200 加提示,不要硬发 302。

验证

响应状态码是 302,Location 头存在且浏览器完成跳转,日志里不再出现 Cannot modify header information,页面也没有多余空白。

小结

这个警告永远是“已经输出了才改头”。先找 BOM 和空行,再开输出缓冲,最根本的还是把跳转放在输出之前。

您可以还会对下面的文章感兴趣: