ProxyErrorOverride本身不提供错误页，仅允许用ErrorDocument接管代理错误；必须为502/503等状态码单独配置ErrorDocument，并用ProxyPass /errors/ !排除路径以防被二次代理。
ProxyErrorOverride 不重写错误页，也不注入路径；它只是“松开手”，让你能用 ErrorDocument 接管代理错误的响应体——但接管前，你得先避开几个关键陷阱。
ProxyErrorOverride 为什么没生效？
最常见的情况是：只写了 ProxyErrorOverride On，却没配对应的 ErrorDocument。这个指令本身不提供页面、不改状态码、不注入任何内容，它只是告诉 Apache：“当后端返回 502/503/504 这类代理错误时，允许我用 ErrorDocument 指定的路径来替换响应体”。
- 必须为每个想覆盖的状态码单独声明，比如：
ErrorDocument 502 /errors/50x.html、ErrorDocument 503 /errors/50x.html - 路径必须以
/开头，且是 Apache 能直接服务的本地 URI（不能是file:///或http://） - 如果该路径本身也被
ProxyPass捕获（例如你配了ProxyPass / http://backend/），错误页请求会被转发到后端，导致二次 502 或无限循环
如何防止错误页被再次代理？
在 ErrorDocument 指向的路径上显式排除代理，否则 Apache 会按顺序匹配规则，把 /errors/50x.html 当作普通请求继续转发给后端。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 加一条
ProxyPass /errors/ !（注意末尾空格和感叹号） - 确保
/errors/目录放在 DocumentRoot 下，且 Apache 用户有读取权限 - 页面内引用资源（CSS/JS/图片）全部用根路径，比如
/errors/style.css，避免相对路径因请求上下文错位而 404
ProxyPassReverse 能不能配合错误页做路径注入？
不能。ProxyPassReverse 只修改响应头里的 Location、Content-Location 和 URI 字段，对错误页的 HTML 内容、内联脚本、表单 action 或静态资源链接完全无感。它也不处理状态码为 5xx 的响应体。
- 如果你在错误页里硬编码了
action="/login"，而实际代理前缀是/app/，那这个表单提交就会失败——ProxyPassReverse帮不上忙 - 需要路径注入的场景（如统一加前缀），只能靠动态生成页面（PHP/SSI）或前端 JS 补全，Apache 代理层不参与
- 若后端返回的是带绝对路径的
Location: https://127.0.0.1:8080/login，ProxyPassReverse必须严格匹配协议+主机+端口才能替换，写成http://127.0.0.1:8080/就会失效
自定义错误页里怎么保持原始状态码？
Apache 默认维持原始错误码（如 502），但一旦你用 PHP 或 SSI 渲染错误页，就可能被重置为 200——浏览器看到 200 就不会触发错误页样式，甚至影响监控告警。
- PHP 中必须手动调用：
http_response_code(502)（注意不是 echo 或 header("HTTP/1.1 502")） - SSI 页面可用
<!--#set var="status" value="502 Service Unavailable" --> - 纯静态 HTML 不用处理，但要确认没被其他模块（如 mod_security 规则）悄悄改码
真正容易被忽略的是作用域问题：ProxyErrorOverride 是目录级指令，写在 <Location> 里只对该路径生效，但如果你的 ErrorDocument 路径不在同一作用域下，它就压根看不到——最好统一放在 <VirtualHost> 顶层，避免嵌套混乱。
