ProxyPassReverse的核心作用是重写后端返回的Location等响应头，确保302等重定向指向公网域名而非内网地址；必须与ProxyPass路径严格一致配置，否则重定向失效。
ProxyPassReverse 的核心作用是修正后端返回的重定向响应（如 302、301）中的 Location 头，避免用户被跳转到内网地址或错误端口。它不是可选项，而是反向代理能正常工作的必要配置。
为什么必须配 ProxyPassReverse
Java 应用（比如 Spring Boot）在登录成功、表单提交后常返回 302 响应，并在 Header 中写入 Location: http://127.0.0.1:8080/dashboard。如果没有 ProxyPassReverse，Apache 会原样把这条头发给浏览器——用户就直接跳到了不可访问的内网地址，页面报错或空白。
ProxyPassReverse 会自动扫描后端返回的所有 Location、Content-Location 和 URI 响应头，把其中匹配 ProxyPass 目标地址的部分替换成前端域名路径。例如：
- 后端返回：Location: http://127.0.0.1:8080/api/user
- 你配置了：ProxyPass / http://127.0.0.1:8080/
- ProxyPassReverse 就会把它改写成：Location: https://app.example.com/api/user（协议和域名由客户端原始请求决定）
配置时的关键细节
ProxyPass 和 ProxyPassReverse 的路径必须严格一致：都带尾部斜杠，或都不带。否则替换逻辑失效。
- ✅ 正确（都带 /）：ProxyPass / http://127.0.0.1:8080/ + ProxyPassReverse / http://127.0.0.1:8080/
- ❌ 错误（不一致）：ProxyPass /api http://127.0.0.1:8080/api + ProxyPassReverse /api/ http://127.0.0.1:8080/api/ → 路径拼接出错，Location 可能变成 /api//login
如果只代理子路径（如 /admin），ProxyPassReverse 后面的 URL 也必须对应子路径起点：
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- ProxyPass /admin/ http://127.0.0.1:8080/
- ProxyPassReverse /admin/ http://127.0.0.1:8080/
配合 ProxyPreserveHost 使用更稳妥
ProxyPreserveHost On 让 Apache 把原始 Host 请求头（如 app.example.com）传给后端。这样 Java 应用生成重定向时，就能基于真实域名构造 Location，而不是硬编码 localhost 或 IP。
即使有了 ProxyPassReverse，若后端自己拼了错误的绝对 URL（比如用 request.getScheme() + "://" + request.getServerName()），仍可能跳错。所以建议两者并用：
- ProxyPreserveHost On
- ProxyPass / http://127.0.0.1:8080/
- ProxyPassReverse / http://127.0.0.1:8080/
这样无论后端用相对路径跳转（推荐），还是用绝对 URL，都能被正确处理。
验证是否生效的小技巧
打开浏览器开发者工具 → Network 标签页 → 触发一次登录或提交操作 → 找到 302 响应 → 点开 Headers → 查看 Response Headers 中的 Location 值。它应该显示你的公网域名（如 https://app.example.com/xxx），而不是 127.0.0.1、localhost 或内网 IP。
如果看到的是内网地址，说明 ProxyPassReverse 没生效，优先检查模块是否加载、路径是否一致、配置是否在正确的 VirtualHost 块中。
