VS Code本地PHP8.0环境header重定向不生效如何排查解决

核心坑点先排查：你改的配置文件根本没生效 #

php.ini-development是PHP官方提供的配置参考模板，PHP运行时不会加载这个文件，改了也不会产生任何效果。

• 新建phpinfo.php写入<?php phpinfo();，访问后找到Loaded Configuration File项，这个路径指向的文件才是当前PHP实际读取的生效配置
• 打开这个生效的ini文件，确认output_buffering = 4096没有被分号注释，修改后必须重启本地Web服务（Apache/Nginx/PHP内置服务），配置才会加载
• 回到phpinfo页面确认output_buffering的实际值显示为4096，说明配置确实生效了

第二步：确认header调用前没有任何提前输出 #

哪怕是文件开头的一个空格、UTF-8 BOM头、提前的echo输出、报错信息，都会导致HTTP头提前发送，后续header调用失效。在代码最开头加错误提示，在header前加检测逻辑：

<?php
// 所有代码最最开头加
error_reporting(E_ALL);
ini_set('display_errors', 1);
ob_start(); // 只需要在最开头开一次缓冲就行，不要乱调用ob_flush/ob_clean

// 你的其他业务逻辑
// ...

// 调用header前加检测
if (headers_sent($out_file, $out_line)) {
    exit("HTTP头已在 {$out_file} 第 {$out_line} 行提前输出，无法执行重定向");
}
$reroutePath = "Location: http://" . $_SERVER['HTTP_HOST'] . "/test.php";
header($reroutePath);
// 必须加exit终止后续执行，否则PHP会继续跑完后面的代码
exit;

注意：不要在header前调用ob_flush()，这个函数会直接把缓冲区内容输出到浏览器，反而会造成头提前发送，完全起不到帮助作用。如果你的文件存成了带UTF-8 BOM的格式，把文件重新保存为「UTF-8 无BOM」格式即可，BOM是不可见的提前输出，很多开发者踩过这个坑。

第三步：排除调试环境和测试方式的干扰 #

你在VS Code里逐行调试时不跳转是正常现象：Xdebug断点拦截状态下，响应不会完整发送给浏览器，自然不会触发跳转，不要卡在断点上等跳转。

• 放开断点让代码完整执行，打开浏览器F12网络面板，查看对应请求的响应头：如果响应头里存在Location: http://localhost/test.php字段，说明PHP代码逻辑完全正常，问题出在浏览器/插件侧
• 不要用VS Code的内置预览页测试，用系统安装的Chrome/Edge直接访问localhost地址，内置预览页经常存在响应拦截、跳转限制的问题
• 检查本地浏览器的广告拦截、安全类插件，部分插件会拦截localhost下的自动跳转
• 确认站点根目录下确实存在test.php文件，没有被本地服务的路由规则拦截

快速排除代码问题 #

如果以上排查都做完还是有问题，可以临时写个最简单的测试文件排除业务代码干扰：

<?php
header("Location: http://localhost/test.php");
exit;

直接访问这个测试文件，如果能正常跳转，说明是你原有业务代码里存在提前输出、逻辑中断的问题，和PHP配置无关。

内容的提问来源于stack exchange，提问作者Miff