ProxyErrorOverride本身不自动统一错误页面，需在每个<VirtualHost>内开启并配合显式ErrorDocument配置各状态码页面，同时用ProxyPass !排除错误页路径以防代理误转发。
proxyerroroverride 本身不能“自动统一”错误页面，它只是一个开关，是否接管错误响应取决于你是否在对应作用域中显式配置了 errordocument，并且要避开代理规则对错误页路径的误转发。在虚拟主机层级做配置，核心是让每个 <virtualhost> 独立控制自己的错误行为，而不是全局一刀切。
以下是在 Apache 虚拟主机层级正确配置 ProxyErrorOverride + 自定义错误页的关键点：
1. 在每个 VirtualHost 内开启 ProxyErrorOverride 并配 ErrorDocument
ProxyErrorOverride 是目录级指令，写在 <VirtualHost> 块内即对该站点生效。但仅开 On 不够——必须为每个想覆盖的状态码（如 502、503）单独指定 ErrorDocument：
<VirtualHost *:80>
ServerName site-a.com
ProxyPass / http://backend-a:8080/
ProxyPassReverse / http://backend-a:8080/
# 开启接管能力
ProxyErrorOverride On
# 显式声明哪些错误由谁来呈现
ErrorDocument 502 /errors/502.html
ErrorDocument 503 /errors/503.html
ErrorDocument 404 /errors/404.html
</VirtualHost>注意：/errors/502.html 是以 / 开头的 URI 路径，不是文件系统路径；该路径下的 HTML 文件需真实存在于网站根目录或别名映射位置。
2. 排除错误页路径被再次代理（关键防坑）
如果 ProxyPass / http://... 没加限制，Apache 会把对 /errors/502.html 的请求也转发给后端，导致 404 或空白页。必须用 ProxyPass ! 显式排除：
# 加在同一个 VirtualHost 内，且必须在 ProxyPass 之后（顺序重要） ProxyPass /errors/ !
这样 /errors/ 下所有资源（HTML/CSS/JS）都由 Apache 本地服务，不走代理。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
3. 确保错误页资源可直接访问且路径稳定
- 错误页 HTML 中引用的 CSS、图片等，建议用根路径（如
/errors/style.css），避免相对路径因重定向导致加载失败 - 不要用 PHP 等动态脚本生成错误页，除非手动设置状态码：
http_response_code(502);，否则浏览器可能收到 200 导致渲染异常 - 页面响应头中的
Content-Type应为text/html，Apache 默认会设好，无需额外干预
4. 多个虚拟主机可完全独立配置
不同 <VirtualHost> 可用不同路径、不同页面、不同状态码策略，互不影响：
<VirtualHost *:80>
ServerName site-b.com
ProxyPass / http://backend-b:9000/
ProxyPassReverse / http://backend-b:9000/
ProxyErrorOverride On
ErrorDocument 503 /maintenance.html # 完全不同的路径和内容
ProxyPass /maintenance.html ! # 同样需要排除
</VirtualHost>只要每个站点的 ErrorDocument 指向的是本机可服务的 URI，且该 URI 已被 ProxyPass ! 排除，就能实现各站点错误页面的独立定制与统一接管。
