现象
登录校验通过后调用 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 和空行,再开输出缓冲,最根本的还是把跳转放在输出之前。
