关键是要组合配置ProxyErrorOverride、ErrorDocument、ProxyPass !排除路径及状态码控制：必须为502/503等显式设置ErrorDocument指向本地URI，用ProxyPass /errors/ !排除该路径以防被代理，并确保错误页响应保持原始状态码。

要在 apache 虚拟主机中用 proxyerroroverride 统一管理后端异常状态码（如 502/503/504），关键不是只开这个指令，而是把它和 errordocument、路径排除、状态码显式映射三者组合使用。单独启用 proxyerroroverride on 不会自动替换代理错误页，它只是“允许接管”，真正起作用的是你为每个状态码配的本地错误页。

必须显式配置 ErrorDocument 映射每个状态码

ProxyErrorOverride 默认不接管反向代理产生的错误（比如后端宕机返回的 502），只接管 Apache 自身生成的错误（如 404）。所以必须手动告诉 Apache：遇到哪些状态码时，用哪个本地页面替代。

• 在 块内添加类似以下语句：
• ErrorDocument 502 /errors/50x.html
• ErrorDocument 503 /errors/50x.html
• ErrorDocument 504 /errors/50x.html
• 路径必须以 / 开头，是 Apache 可直接服务的 URI（如对应 /var/www/html/errors/50x.html），不能是文件系统路径或外部 URL

必须用 ProxyPass ! 排除错误页路径

如果错误页路径（例如 /errors/）也被 ProxyPass / http://backend/ 捕获，Apache 会把请求再次转发给后端，导致 404 或循环失败。

• 在所有 ProxyPass 规则之后，立即加排除规则：
• ProxyPass /errors/ !
• 同样建议排除静态资源路径：ProxyPass /static/ !、ProxyPass /css/ ! 等
• 确保这些路径下的 HTML/CSS/JS 都放在 DocumentRoot 对应位置，由 Apache 直接响应

确保错误页响应保持原始状态码

浏览器是否显示自定义页，取决于响应头中的状态码是否匹配。静态 HTML 页面默认继承原始状态码（如 502），无需额外操作；但若用 PHP 动态生成，需手动维持：

Bailian Usage Proxy

阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。

下载

• PHP 页面开头加：
• 避免在错误页里做 302 重定向，否则浏览器看到的是 302，而不是 502，ErrorDocument 逻辑就失效了
• 页面内引用资源（CSS/JS）建议用根路径（如 /errors/style.css），防止因路径上下文错乱导致加载失败

ProxyErrorOverride 的作用域与启用位置

该指令是目录级指令，在虚拟主机中启用才对整个代理生效：

• 必须写在 块内（而非 或全局），否则不覆盖代理错误
• 多个 ProxyPass（如 /api/ 和 /admin/）共存时，ProxyErrorOverride On 应统一放在 顶层，不要分散配置
• 它不会穿透 ProxyPass 边界自动生效，只对当前虚拟主机范围内被代理触发的错误有效