apache默认透传后端返回的401、429、503等状态码，proxyerroroverride仅接管代理层502/503/504，不处理后端主动返回的错误；需通过errordocument配合重定向、mod_rewrite检测响应头或php脚本动态设置状态码统一干预。
Apache 反向代理默认会原样透传后端返回的任何状态码，包括 401、429、503 等业务自定义错误。它不自动拦截、不重写、也不美化——要统一处理这些状态码，必须靠显式配置组合实现。
后端返回的错误码 ≠ Apache 自身错误
这是最关键的区分点：
- ProxyErrorOverride 只接管 Apache 自己生成的 502/503/504（比如连不上后端、超时）
- 后端主动返回的 401、429、503、507 等，Apache 默认完全透传，ProxyErrorOverride 对它们无效
- 想干预这些响应，必须让 Apache “感知到”并主动介入，不能依赖代理模块自动识别语义
用 ErrorDocument + 后端配合重定向（推荐入门）
最轻量、兼容性最好的方式：让后端在返回特殊状态时，附带 Location 头跳转到预设路径，再由 Apache 提供本地页面。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 后端返回示例（如 Node.js）：
res.status(429).set('Location', '/rate-limited').end() - Apache 配置对应路径（放在 VirtualHost 内）：
ErrorDocument 429 /rate-limited.htmlProxyPass /rate-limited.html !ProxyPass /static/ ! - 确保
/var/www/html/rate-limited.html文件真实存在，且能被 Apache 直接服务
用 mod_rewrite + 响应头检测（更精准可控）
适合需要保留原始状态码、或后端无法修改跳转逻辑的场景。要求 Apache 2.4.13+，并启用 mod_headers 和 mod_rewrite。
- 让后端响应中带上明确标记，例如：
X-Handled-Error: 429 - Apache 中添加检测与重写规则：
RewriteCond %{RESPONSE_HEADERS} "X-Handled-Error: 429"<br> RewriteRule ^ - [R=429,L] - 再配好对应页面：
ErrorDocument 429 /errors/429.html
同样需提前排除：ProxyPass /errors/ ! - 注意开启调试日志：
LogLevel rewrite:trace3，便于排查匹配是否生效
静态页 vs 动态页的状态码保持
浏览器是否把页面当“错误页”展示，取决于响应头里的状态码是否匹配。
- 纯 HTML 错误页（如
/errors/401.html）：Apache 自动维持原始状态码，无需额外操作 - PHP 动态页（如
/errors/401.php）：PHP 默认返回 200，必须手动设置：<?php http_response_code(401); ?> - 避免在错误页里做 302 跳转，否则原始错误语义丢失，前端无法做状态判断
