如何通过Apache mod_proxy配置实现自定义错误重写与路径注入改写？

本文共计958个文字，预计阅读时间需要4分钟。

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 当作普通请求继续转发给后端。