Apache中统一捕获后端异常需启用ProxyErrorOverride并配合ErrorDocument逐个声明502/503/504等错误页，同时用ProxyPass /errors/ !排除错误路径被代理，确保静态资源直供且维持原始状态码。
要在 Apache 中用 mod_proxy 实现对后端服务的统一异常捕获与重定向，核心不是“自动拦截所有错误”，而是主动声明哪些错误码由 Apache 自己响应、并确保这些响应不被代理规则误转发。关键在于 ProxyErrorOverride 与 ErrorDocument 的协同配置，同时排除错误页路径被再次代理。
启用 ProxyErrorOverride 并理解它的作用边界
ProxyErrorOverride On 本身不生成页面，也不接管代理模块产生的 502/503 错误——它只是“允许”你用 ErrorDocument 覆盖这些状态码。若未配 ErrorDocument，该指令完全无效。
- 必须写在
<VirtualHost>或全局上下文中，不能只放在某个<Location>内 - 它只影响当前配置段生效范围，不会穿透
ProxyPass边界自动生效 - 开启后，Apache 仍默认只接管自身触发的错误（如 404、403），代理错误需显式声明
为每个目标错误码配置 ErrorDocument
502、503、504 等代理类错误必须逐个指定本地 URI 页面：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
ErrorDocument 502 /errors/50x.htmlErrorDocument 503 /errors/50x.htmlErrorDocument 504 /errors/50x.html
注意：路径必须是以 / 开头的本地可访问 URI，不能是文件系统路径或外部 URL；页面内容应静态、轻量，避免依赖后端服务。
排除错误页路径被 ProxyPass 拦截
如果已配置 ProxyPass / http://backend/，那么请求 /errors/50x.html 也会被转发给后端，导致 404 或循环错误。
- 在
ProxyPass规则前添加排除项：ProxyPass /errors/ ! - 确保
/errors/下的 HTML、CSS、JS 都通过 Apache 直接提供，不走代理 - 页面内资源引用推荐用根路径（如
/errors/style.css），避免相对路径错位
保持原始状态码并验证响应行为
自定义错误页返回时，Apache 默认维持原始状态码（如 503），这对浏览器渲染和监控很重要。但若页面含 PHP 或动态逻辑，需手动设置：
- PHP 中调用
http_response_code(503) - 用 curl 或浏览器开发者工具检查响应头，确认
Status: 503 Service Unavailable - 停掉后端服务，触发 503，观察是否返回你的页面且无重定向跳转
