Apache中统一接管后端502/503/504错误页需四步协同：启用ProxyErrorOverride开关、为各状态码显式配置ErrorDocument、用ProxyPass !排除错误页路径、动态页手动维持原始状态码；静态页无须额外处理。
ProxyPass 本身不处理错误页面，它只负责转发请求；要让后端返回 502/503/504 等错误时显示自定义页，必须配合 ProxyErrorOverride 开关、ErrorDocument 映射、路径排除和状态码保持四步一起配。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
必须显式启用 ProxyErrorOverride 并配 ErrorDocumentProxyErrorOverride On 只是个开关，不提供页面，也不自动接管任何错误。它只是“允许你用本地页面覆盖代理错误”，前提是已为对应状态码声明 ErrorDocument：
-
ErrorDocument 502 /errors/50x.html -
ErrorDocument 503 /errors/50x.html -
ErrorDocument 504 /errors/50x.html
路径必须以/开头，是 Apache 能直接服务的 URI（如/errors/50x.html），不能是文件系统路径或外部 URL。
错误页路径必须用 ProxyPass ! 排除
如果错误页路径（如 /errors/）没被排除，而主规则是 ProxyPass / http://backend/，Apache 会把对 /errors/50x.html 的请求再次转发给后端，导致 404 或循环失败：
-
ProxyPass /errors/ ! - 同样排除静态资源路径：
ProxyPass /static/ !、ProxyPass /css/ !
确保这些路径下的文件真实存在于DocumentRoot对应位置（例如/var/www/html/errors/50x.html）。
动态错误页需手动维持原始状态码
若错误页由 PHP 生成，默认响应头会是 200 OK，浏览器无法识别为错误页，接管逻辑失效：
- PHP 文件开头加
<?php http_response_code(502); ?> - 避免在错误页中使用
header("Location: ...")，否则状态码变成302，彻底绕过错误处理流程
静态 HTML 无此问题，Apache 默认保留原始502/503状态码。
兜底跳转可复用 ErrorDocument 或结合 mod_rewrite
当所有后端不可用（如负载均衡器检测到无健康节点），可设统一维护页：
- 直接写
ErrorDocument 503 /maintenance.html，并确保/maintenance.html已被ProxyPass /maintenance/ !排除 - 或启用
mod_rewrite做更精细判断（例如检查环境变量）：RewriteCond %{ENV:balancer_worker_route} ^$RewriteRule ^(.*)$ /maintenance.html [R=503,L]
