Apache mod_proxy_balancer 本身不支持多级路径语义聚合，但可通过组合 ProxyPass（按路径前缀绑定独立 balancer:// 组）、RewriteRule（动态提取变量路由）及 ProxyPassReverse 实现精准多级路径分发，需注意路径截断一致性、协议隔离与头信息修正。
apache mod_proxy_balancer 本身不支持“多级路径分发”这种语义聚合（比如把 /api/v1/users 和 /api/v2/orders 自动映射到不同后端并合并响应），它只做请求路由分发。但你可以通过组合 proxypass、rewriterule 和多个 balancer:// 组，实现按路径层级精准调度到不同后端集群——这才是实际可用的“多级路径分发”。
用 ProxyPass 按路径前缀直连不同后端集群
这是最清晰、最可控的方式。每个路径层级对应一个独立的 balancer:// 组，避免逻辑耦合：
-
ProxyPass /api/v1/ balancer://users-v1/→ 后端集群只跑 v1 用户服务 -
ProxyPass /api/v2/ balancer://users-v2/→ 另一组节点跑 v2 版本，便于灰度或蓝绿 -
ProxyPass /admin/ balancer://admin-backend/→ 管理后台走独立集群，隔离权限与资源
注意：每个 balancer://xxx 都需在单独的 <Proxy> 块中定义，不能混在一个块里跨协议或跨用途使用。
用 RewriteRule + ProxyPass 实现动态路径重写再分发
当路径规则较复杂（如 /v1/{service}/... 需提取 service 名跳转），可先用 RewriteRule 提取变量，再用环境变量驱动 ProxyPass：
- 启用
mod_rewrite和mod_proxy - 在
<VirtualHost>内写：
<RewriteCond %{REQUEST_URI} ^/v1/(users|orders|products)/(.*)$
RewriteRule ^/v1/(.*)$ http://backend-%1:8080/%2 [P,L] - 配合
ProxyPassReverse修正响应头，否则跳转和 Cookie 会出错
这种方式灵活但调试成本高，建议仅用于版本路由、租户路由等有明确提取逻辑的场景。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
路径截断与后端路径一致性必须对齐
Apache 的路径转发不是“转发整个 URL”，而是“截掉匹配前缀后拼接”。例如：
-
ProxyPass /api/v1/ http://svc:8080/→/api/v1/users变成/users发给后端 -
ProxyPass /api/v1/ http://svc:8080/api/v1/→/api/v1/users变成/api/v1/users，适合后端强依赖固定上下文路径
务必确认后端服务是否要求特定 context path；若不一致，会导致 404 或静态资源加载失败。末尾斜杠不能省略，它是路径拼接的关键分隔符。
避免常见陷阱：健康检查、头信息、WebSocket
多级路径分发常伴随混合后端（HTTP + WebSocket + API 管理界面），需额外处理：
- WebSocket 路径（如
/ws/）不能走balancer://，必须单独用ProxyPass /ws/ ws://backend:8080/ws/并启用mod_proxy_wstunnel - 所有
ProxyPass都应配对ProxyPassReverse，否则 Location 重定向、Set-Cookie 路径全错 - 开启
ProxyPreserveHost On，让后端看到真实 Host，尤其对生成绝对链接的服务（Spring Boot、Next.js）至关重要 - 健康检查默认只对 HTTP 后端生效；AJP/FCGI 后端需手动配置
ping=5或依赖连接层探测
