PHP 8.2 调用 setcookie 后报 headers already sent,页面跳转不生效怎么排查

现象:setcookie 之后页面跳转不生效

PHP 8.2 项目里登录接口调用 setcookie 再 header 跳转,页面没反应,日志里冒出 Warning: Cannot modify header information - headers already sent by。意思是 HTTP 响应头已经发出去了,再调 header 或 setcookie 就晚了。多数情况不是 PHP 版本问题,而是文件里在 header 之前有内容被输出。

第一步:定位是哪一行先输出了内容

警告里的 output started at xxx.php line N 就是罪魁祸首的位置。常见三类原因:UTF-8 文件带 BOM、PHP 标签外的空格或换行、以及在 header 之前主动 echo 或 print。先打开被点名的文件看对应行附近有没有这些东西。

第二步:去掉文件头的 BOM

Windows 记事本另存为 UTF-8 会自动带 BOM,这三个不可见字符在

file index.php        # 显示 "UTF-8 Unicode (with BOM)" 就是有问题
sed -i '1s/^\xEF\xBB\xBF//' index.php

第三步:纯 PHP 文件删掉结尾的 ?>

PHP 官方建议纯 PHP 文件不写闭合标签,标签后任何空格或换行都会变成输出。删掉 ?> 一了百了,主流框架的源码都是这么做的。如果文件里混有 HTML,那就保证 ?> 后面没有任何字符。

第四步:临时用输出缓冲兜底

历史代码一时改不完,可以在入口文件最前面开 ob_start,所有输出先进缓冲区,header 就能正常发送:

验证

改完清 OPcache 再走一遍登录流程,看响应头里有没有 Set-Cookie 和 Location。如果警告消失但跳转还是不生效,检查 header 之后有没有 exit 或 die,没有的话代码会继续往下跑,可能又输出内容把跳转冲掉。

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