proxypassreverse 与 rewrite 必须协同但分工明确：rewrite 负责动态路径重写与条件代理，proxypassreverse 则需为每个实际后端地址单独配置，严格匹配“路径前缀+目标url”，以修正 location、set-cookie 等响应头，否则前端失效。
proxypassreverse 和 rewrite 可以协同工作，但必须明确分工：rewrite 负责动态判断和重写请求路径（比如按请求头、参数或环境切换后端），而 proxypassreverse 负责修正后端返回的响应头——它不关心你是怎么转发的，只认准你配置的“源路径 → 目标地址”映射关系。
Rewrite 触发代理时，ProxyPassReverse 仍需显式配置
当用 RewriteRule + [P] 实现条件代理（如灰度或环境路由）时，Apache 不会自动推导响应头该怎样改。你必须手动补上与 Rewrite 目标一致的 ProxyPassReverse 规则，否则后端返回的 Location 跳转、Set-Cookie Path 或 Content-Location 仍指向原始后端地址。
- 例如，用 Rewrite 将 /api/ 请求按 X-Env 头分发到不同后端：
RewriteCond %{HTTP:X-Env} ^prod$
RewriteRule ^/api/(.*)$ http://prod-svc:8000/api/$1 [P,L] - 对应必须加一句：
ProxyPassReverse /api/ http://prod-svc:8000/api/ - 如果还有测试环境规则，也要配对应的 ProxyPassReverse：
RewriteCond %{HTTP:X-Env} ^test$
RewriteRule ^/api/(.*)$ http://test-svc:9000/api/$1 [P,L]
ProxyPassReverse /api/ http://test-svc:9000/api/
多个 Rewrite 分支共用同一路径前缀时，ProxyPassReverse 不能合并
即使所有 RewriteRule 都匹配 ^/api/，只要目标后端地址不同，每个都要单独写 ProxyPassReverse。Apache 的 ProxyPassReverse 是按“路径前缀 + 后端地址”成对生效的，不是按路径前缀全局生效。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 错误写法（只写一次，期望覆盖所有后端）：
ProxyPassReverse /api/ http://any-backend:8000/ —— 无效，不匹配实际转发地址 - 正确做法是为每个实际出现的后端 URL 单独声明：
ProxyPassReverse /api/ http://prod-svc:8000/api/
ProxyPassReverse /api/ http://test-svc:9000/api/
ProxyPassReverse /api/ http://canary-svc:8080/v2/api/
Cookie 和域名相关头需额外配合指令
Rewrite + [P] 代理后，后端常在 Set-Cookie 中写 Path=/v2 或 Domain=backend.example.com，这会导致前端无法读取。ProxyPassReverse 本身不处理 Cookie 域名或 Path，得靠专用指令：
-
修正 Cookie 路径：用 ProxyPassReverseCookiePath，例如
ProxyPassReverseCookiePath /v2/ /api/ → 把后端返回的 Path=/v2/ 改成 Path=/api/ -
修正 Cookie 域名：用 ProxyPassReverseCookieDomain，例如
ProxyPassReverseCookieDomain backend.prod app.example.com - 若后端依赖 Host 头生成链接，记得加：
ProxyPreserveHost Off
RequestHeader set Host "backend.prod"
避免常见失效场景
以下情况会导致 ProxyPassReverse “看起来没起作用”：
- 没启用 mod_proxy_http 模块（ProxyPassReverse 依赖它）
- ProxyPassReverse 的路径前缀和 RewriteRule 匹配的路径不一致（比如 Rewrite 匹配 ^/api/，但 ProxyPassReverse 写的是 /api）
- 后端返回了多个 Location 响应头（如 302 嵌套跳转），而 ProxyPassReverse 只改第一个
- 用了 ProxyPass /api/ ! 排除静态资源，但忘记对应排除 ProxyPassReverse —— 它不会自动跳过
