ProxyErrorOverride仅作开关，需配合ErrorDocument、ProxyPass !排除路径及动态页状态码保持才能统一接管502/503/504错误页。
ProxyErrorOverride 本身不提供页面，只起“开关”作用——开启后仍需为每个状态码单独配 ErrorDocument，再配合路径排除和状态码保持，才能真正统一接管 502/503/504 等后端异常页。
必须显式配置 ErrorDocument 映射
ProxyErrorOverride On 不会自动替换任何错误页。它只是允许你用本地页面覆盖代理错误，前提是已声明对应状态码的 ErrorDocument：
- ErrorDocument 502 /errors/50x.html
- ErrorDocument 503 /errors/50x.html
- ErrorDocument 504 /errors/50x.html
路径必须以 / 开头，是 Apache 可直接服务的 URI（如 /errors/50x.html），不能是文件系统路径或外部 URL。静态 HTML 默认继承原始状态码，无需额外处理。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
用 ProxyPass ! 排除错误页路径
若错误页路径（如 /errors/）未被排除，而主代理规则是 ProxyPass / http://backend/，Apache 会把请求再次转发给后端，导致 404 或循环失败：
- 在 ProxyPass 规则之后立即添加：
ProxyPass /errors/ ! - 同样排除静态资源路径：
ProxyPass /static/ !、ProxyPass /css/ ! - 确保这些路径下的文件真实存在于 DocumentRoot 对应位置（如
/var/www/html/errors/50x.html）
动态页面需手动维持状态码
若错误页由 PHP 等动态生成，响应头中的状态码可能被重置为 200，导致浏览器不识别为错误页：
- PHP 页面开头加：
<?php http_response_code(502); ?> - 避免在错误页中做
header("Location: ...")重定向，否则状态码变为 302，接管逻辑失效 - 静态页无此问题，Apache 默认保留原始 502/503 状态码
兜底跳转可结合 mod_rewrite
当所有后端不可用（如负载均衡器检测到无健康节点），可追加最终跳转逻辑：
- 启用 mod_rewrite，在虚拟主机中添加：
RewriteCond %{ENV:balancer_worker_route} ^$ - 后续接：
RewriteRule ^(.*)$ /maintenance.html [R=503,L] - 更轻量的方式是复用 ErrorDocument：直接设
ErrorDocument 503 /maintenance.html，并确保该路径已被ProxyPass /maintenance.html !排除
