Apache主配置文件中怎么配置状态码重写与自定义错误跳转-Apache-PHP中文网

apache无法直接重写状态码，需通过errordocument接管错误页、响应头+mod_rewrite触发跳转、或php手动设码等方式实现；核心是控制用户所见内容与浏览器接收的状态。

在 apache 主配置文件（如 /etc/apache2/apache2.conf 或虚拟主机配置 /etc/apache2/sites-available/000-default.conf）中，不能直接“重写状态码”——apache 不提供 rewritestatus 401 → 302 这类语法。所谓“状态码重写”，实际是拦截特定响应并触发跳转或替换页面，需通过组合指令实现。核心不是改状态码本身，而是控制用户看到什么内容、浏览器收到什么状态。

以下是在主配置中可直接生效的实用配置方式，无需 .htaccess，更稳定、更安全：

配置 ErrorDocument 统一接管代理层错误页

适用于后端宕机、连接超时等产生的 502/503/504：

ProxyErrorOverride On
ErrorDocument 502 /errors/50x.html
ErrorDocument 503 /errors/50x.html
ErrorDocument 504 /errors/50x.html

必须配合 ProxyPass /errors/ ! 排除该路径，否则请求会被再次代理到后端
/errors/50x.html 需真实存在于 DocumentRoot 下（如 /var/www/html/errors/50x.html）
静态 HTML 页面会自动继承原始 502/503 状态码，浏览器地址栏不跳转，但显示自定义内容

拦截后端返回的业务状态码（如 401、429）并跳转

Apache 默认透传这些状态码，需靠响应头 + mod_rewrite 主动干预：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

# 启用响应头读取（确保已加载 mod_headers 和 mod_rewrite）
Header always set X-Handled-Error "true" "expr=%{REQUEST_STATUS} >= 400"

<location></location>
    RewriteCond %{RESPONSE_HEADERS} "X-Handled-Error:.*true"
    RewriteRule ^ - [R=307,L]

要求后端在返回 401 或 429 时，主动加响应头 X-Handled-Error: true
上述规则将触发临时重定向（307），浏览器跳转至 /，再由你自己的逻辑（如登录页）处理
若想跳固定路径（如 /auth/login），把 RewriteRule 改为：
```
RewriteRule ^ - [R=307,L,Redirect=/auth/login]
```

用 ErrorDocument + 内部重写实现“伪接管”4xx

适合不想改后端、又需统一展示的场景：

ErrorDocument 401 /auth/login.html
ErrorDocument 429 /rate-limited.html
ProxyPass /auth/ !
ProxyPass /rate-limited/ !

前提是后端返回 401 时，同时带 Location: /auth/login.html（302 或 307）
Apache 收到重定向后，访问 /auth/login.html 就走本地文件，状态码变为 200（或保持 401，取决于是否启用内部重写）
ProxyPass /auth/ ! 确保该路径不被代理，避免循环

强制维持动态错误页的状态码

若用 PHP 输出错误页（如 /errors/503.php），必须手动设状态：

<?php http_response_code(503);
?>服务暂时不可用

不加 http_response_code()，PHP 默认返回 200 OK，浏览器不会识别为错误页
错误页中禁止 header("Location: ...")，否则状态码变成 302，接管失效

不复杂但容易忽略