proxypassreverse 用于修正后端返回的 location、content-location 和 uri 响应头，使其匹配代理前路径；其首个参数必须与 proxypass 前缀完全一致（含结尾斜杠），否则重写失效，且仅处理相对路径或同域绝对路径，对跨域完整 url 需配合 header edit 或后端返回相对路径。
ProxyPassReverse 的作用是修正后端服务器返回的 Location、Content-Location 和 URI 响应头，让客户端看到的是代理前的路径，而不是后端真实地址。当配合子路径（比如 /api/）使用时，关键在于路径映射的一致性和响应头重写的准确性。
子路径代理的基本写法
假设你要把 https://example.com/api/ 代理到后端 http://127.0.0.1:3000/，且后端服务本身不带 /api 前缀：
-
ProxyPass /api/ http://127.0.0.1:3000/—— 把请求路径中以/api/开头的部分，去掉前缀后转发给后端 -
ProxyPassReverse /api/ http://127.0.0.1:3000/—— 自动将后端返回的Location: /user改成/api/user
注意：ProxyPassReverse 的第一个参数必须和 ProxyPass 的前缀路径完全一致（包括结尾斜杠），否则重写会失效。
常见错误：后端返回带绝对路径的 Location
如果后端返回 Location: https://backend.example.com/login 这类完整 URL，ProxyPassReverse 默认不处理——它只改相对路径或同域的绝对路径（如 /login）。此时需手动补救：
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 用
Header edit指令强制替换（需加载mod_headers）：Header edit Location "^https?://[^/]+(/.*)$" "/api$1" - 或让后端返回相对路径（推荐），避免硬编码完整域名
多级子路径与嵌套代理
比如代理 /v1/api/data/ 到 http://srv:8080/data/：
ProxyPass /v1/api/data/ http://srv:8080/data/ProxyPassReverse /v1/api/data/ http://srv:8080/data/
这时 Apache 会把后端返回的 /data/list → 改成 /v1/api/data/list；但若后端返回的是 /list（即根路径下），它会被转成 /v1/api/list（错误）。所以务必确保后端响应路径与代理路径结构对齐，或统一用 ProxyPassReverse + ProxyPassReverseCookieDomain + ProxyPassReverseCookiePath 补全 Cookie 处理。
调试技巧
开启 LogLevel proxy:trace4 查看实际转发与响应头改写过程；用 curl -I 验证返回的 Location 是否已按预期重写。不复杂但容易忽略细节。
