proxyerroroverride本身不接管错误页，仅允许errordocument替换代理错误；必须与errordocument同作用域配置，且需用proxypass /errors/ !排除错误页路径以防被代理。
ProxyErrorOverride 本身不接管后端错误页面，它只是“松开闸门”——允许你用 ErrorDocument 去替换代理过程中产生的特定错误响应。不开这个开关，ErrorDocument 502 /errors/50x.html 就是摆设；开了但没配 ErrorDocument，照样透出 Apache 默认的丑陋 502/503 页面。
为什么开了 ProxyErrorOverride On 还看到默认 503 页面？
根本原因是：Apache 默认只接管自身生成的错误（如 404、403），而 502 Bad Gateway、503 Service Unavailable 是 mod_proxy 模块生成的代理层错误，ProxyErrorOverride 不自动绑定任何页面，必须显式声明每个状态码的兜底路径。
-
ProxyErrorOverride On必须出现在和ErrorDocument相同作用域（如同一<virtualhost></virtualhost>或同一<location></location>） - 每个想覆盖的状态码都得单独写一行
ErrorDocument，例如：ErrorDocument 502 /errors/50x.html、ErrorDocument 503 /errors/50x.html -
ErrorDocument后面的路径必须是本地可访问的 URI（以/开头），不能是文件系统路径（如/var/www/html/50x.html）或外部 URL（如https://example.com/50x.html）
如何防止自定义错误页被再次代理？
最常踩的坑：你配置了 ProxyPass / http://backend/，又把错误页放在 /errors/50x.html，但没排除该路径——Apache 会把对 /errors/50x.html 的请求也转发给后端，导致 404 或无限循环。
WebChat Voice Proxy
下载
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
- 在
ProxyPass规则之后、同一配置段内，加一条排除规则：ProxyPass /errors/ ! - 确保
/errors/下所有资源（HTML/CSS/JS/图片）都由 Apache 直接服务，不要依赖后端提供 - 页面内引用资源用根路径，比如
<link rel="stylesheet" href="/errors/style.css">，避免相对路径因请求上下文错乱而加载失败 - 确认返回状态码仍是原始错误码（如 502），不要在动态页面里意外改成 200；静态 HTML 默认维持原码，PHP 等需手动调用
http_response_code(502)
ProxyErrorOverride 的作用域和继承限制
它不是全局开关，也不是“穿透式”生效——它的作用范围严格取决于所在配置块，且不会跨 ProxyPass 边界传播。
- 写在
<virtualhost></virtualhost>里，影响整个虚拟主机下所有代理路径；写在<location></location>里，只对该路径生效 - 如果你有多个
ProxyPass（如/api/和/admin/），别把ProxyErrorOverride On分散写在不同<location></location>里，统一提到<virtualhost></virtualhost>层级更可靠 - 手册明确说明：该指令不支持
<directory></directory>或.htaccess上下文，只能用于 server config、virtual host、proxy、location —— 所以别指望用.htaccess动态开启
ErrorDocument，只要没加 ProxyPass /errors/ !，整个机制就卡死在第一步。这不是配置遗漏，而是逻辑闭环没闭上。
