关键是要组合配置ProxyErrorOverride、ErrorDocument、ProxyPass !排除路径及状态码控制：必须为502/503等显式设置ErrorDocument指向本地URI，用ProxyPass /errors/ !排除该路径以防被代理，并确保错误页响应保持原始状态码。
要在 apache 虚拟主机中用 proxyerroroverride 统一管理后端异常状态码（如 502/503/504），关键不是只开这个指令，而是把它和 errordocument、路径排除、状态码显式映射三者组合使用。单独启用 proxyerroroverride on 不会自动替换代理错误页，它只是“允许接管”，真正起作用的是你为每个状态码配的本地错误页。
必须显式配置 ErrorDocument 映射每个状态码
ProxyErrorOverride 默认不接管反向代理产生的错误（比如后端宕机返回的 502），只接管 Apache 自身生成的错误（如 404）。所以必须手动告诉 Apache：遇到哪些状态码时，用哪个本地页面替代。
- 在
<virtualhost></virtualhost>块内添加类似以下语句： ErrorDocument 502 /errors/50x.htmlErrorDocument 503 /errors/50x.htmlErrorDocument 504 /errors/50x.html- 路径必须以
/开头，是 Apache 可直接服务的 URI（如对应/var/www/html/errors/50x.html），不能是文件系统路径或外部 URL
必须用 ProxyPass ! 排除错误页路径
如果错误页路径（例如 /errors/）也被 ProxyPass / http://backend/ 捕获，Apache 会把请求再次转发给后端，导致 404 或循环失败。
Bailian Usage Proxy
下载
阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。
- 在所有
ProxyPass规则之后，立即加排除规则： ProxyPass /errors/ !- 同样建议排除静态资源路径：
ProxyPass /static/ !、ProxyPass /css/ !等 - 确保这些路径下的 HTML/CSS/JS 都放在
DocumentRoot对应位置，由 Apache 直接响应
确保错误页响应保持原始状态码
浏览器是否显示自定义页，取决于响应头中的状态码是否匹配。静态 HTML 页面默认继承原始状态码（如 502），无需额外操作；但若用 PHP 动态生成，需手动维持：
- PHP 页面开头加：
<?php http_response_code(502); ?> - 避免在错误页里做
302重定向，否则浏览器看到的是 302，而不是 502，ErrorDocument逻辑就失效了 - 页面内引用资源（CSS/JS）建议用根路径（如
/errors/style.css），防止因路径上下文错乱导致加载失败
ProxyErrorOverride 的作用域与启用位置
该指令是目录级指令，在虚拟主机中启用才对整个代理生效：
- 必须写在
<virtualhost></virtualhost>块内（而非<location></location>或全局），否则不覆盖代理错误 - 多个
ProxyPass（如/api/和/admin/）共存时，ProxyErrorOverride On应统一放在<virtualhost></virtualhost>顶层，不要分散配置 - 它不会穿透
ProxyPass边界自动生效，只对当前虚拟主机范围内被代理触发的错误有效
