将404错误文档改造为路由脚本：如何设置HTTP状态码？

这个问题我之前踩过坑！核心原因是Apache在触发ErrorDocument的时候，已经提前把404状态码发送给客户端了，单纯调用http_response_code(200)有时候会被Apache的默认设置覆盖掉。下面给你几个亲测有效的解决办法：

方法一：先清空输出缓冲再设置状态码 #

Apache发送404状态码后，PHP的输出缓冲可能已经有内容了，这时候直接设置状态码会失效。你需要先清空缓冲，再发送200状态码，确保在任何页面输出（包括空格、HTML标签）之前执行这些操作。

完整示例代码：

<?php
// 清空所有可能的输出缓冲内容
ob_clean();
// 发送标准的200响应头，覆盖Apache的404
header("HTTP/1.1 200 OK");
// 或者用兼容旧PHP版本的写法
// header("Status: 200 OK");

// 现在可以正常输出你的内容了
?>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>自定义页面</title>
</head>
<body>
    <h1>这是返回200状态的页面内容</h1>
    <p>你的路由逻辑可以在这里处理</p>
</body>
</html>

方法二：开启输出缓冲并控制输出流程 #

如果你的脚本有较多前置逻辑，建议一开始就开启输出缓冲，确保状态码能优先发送：

<?php
// 提前开启输出缓冲
ob_start();

// 这里写你的路由处理逻辑
// ...

// 清空缓冲（避免之前的逻辑产生输出）
ob_clean();
// 设置200状态码
http_response_code(200);

// 输出最终内容
?>
<html>
<!-- 页面内容 -->
</html>
<?php
// 把缓冲内容发送给客户端
ob_end_flush();
?>

关键注意事项 #

• 绝对不能有前置输出：PHP脚本的<?php标签前面不能有任何空格、换行或者HTML代码，否则header会因为“已发送输出”而失效。
• 非标准Apache的特殊情况：如果服务商的Apache做了定制化配置，可能需要检查是否有模块（比如mod_headers）限制了状态码修改。如果上面的方法都不行，可以尝试在.htaccess中添加：

  Header unset Status
  

  然后再用PHP设置状态码，这能强制清空Apache默认发送的状态头。

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