ProxyErrorOverride On 仅允许 ErrorDocument 接管代理错误，需配合 ProxyPass /errors/ ! 排除路径和 ErrorDocument 502 /errors/502.html 指向本地静态页，页面须置于文档根下且避免被代理。
在 Apache 中用 mod_proxy 实现自定义错误页面，**不是靠“重写错误页面内容”或“注入后端路径到错误页”**，而是通过正确组合 ProxyErrorOverride、ErrorDocument 和 ProxyPass ! 三者，让 Apache 在代理出错时（如 502/503）主动返回你准备好的本地 HTML 页面，同时避免该页面被再次代理或路径错乱。
明确核心逻辑：ProxyErrorOverride 不是万能开关
ProxyErrorOverride On 本身不提供页面，也不改写响应体。它只是“松开限制”，允许你用 ErrorDocument 指令接管原本由代理模块生成的错误（比如后端宕机导致的 502 Bad Gateway）。但前提是：
- 必须为每个目标状态码显式配置
ErrorDocument，例如：ErrorDocument 502 /errors/502.html - 该路径（如
/errors/）不能被任何ProxyPass规则捕获，否则请求会发往后端，而非由 Apache 直接服务 - 页面必须放在 Apache 可直接读取的文档根目录下（如
/var/www/html/errors/502.html），且路径以/开头（URI 形式）
关键配置步骤：排除 + 指向 + 确保可访问
假设你的主代理规则是 ProxyPass / http://backend:8000/，想为 502/503 提供统一错误页：
aperture: the L402 aware reverse proxy
下载
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
- 在
<VirtualHost>或全局配置中启用接管：ProxyErrorOverride On - 添加错误页映射：
ErrorDocument 502 /errors/maintenance.html，ErrorDocument 503 /errors/maintenance.html - **必须排除错误页路径**，防止被代理：
ProxyPass /errors/ !（注意末尾空格和感叹号） - 确认
/var/www/html/errors/maintenance.html文件存在，且其中引用的 CSS/JS 使用根路径（如/errors/style.css），不依赖后端提供
为什么不能“注入后端路径”到错误页？
Apache 的错误页机制是静态响应：当触发 502 时，Apache 直接返回你指定的 HTML 文件，并保持响应状态码为 502。它不会解析页面内容、也不会把后端地址、请求路径等变量自动填入 HTML。如果你需要动态内容（比如显示用户原请求的 URL），需借助服务器端脚本（如 PHP）：
- 把错误页设为
ErrorDocument 502 /errors/502.php - 在
502.php中用$_SERVER['REQUEST_URI']获取原始路径，再输出 HTML - 确保该 PHP 路径也被
ProxyPass /errors/ !排除，且 PHP 模块已启用
常见失效原因与验证方法
页面没出来？大概率卡在这几个点：
- 忘了加
ProxyPass /errors/ !—— 错误页请求被转发给挂掉的后端，返回 503 或超时 -
ErrorDocument路径写成文件系统路径（如/var/www/errors/502.html）或外部 URL（如https://example.com/502.html）—— Apache 会忽略 - 页面体积小于 256 字节（IE 要求 512 字节）—— 浏览器可能拒显，建议加几行注释凑够大小
- 配置未生效：修改后执行
sudo apachectl configtest && sudo systemctl reload apache2，别只重启
