Apache ProxyPass需按路径层级自上而下精准声明，从具体到宽泛；用<Location>包裹提升可维护性；子路径代理须确保前后斜杠一致，避免路径拼接错误。
要让 Apache 通过 ProxyPass 精准转发多级业务路径（比如 /admin/api/v2/、/user/profile/、/assets/js/），关键不是“智能识别”，而是**按路径层级明确声明、严格控制匹配顺序、协同后端适配资源路径**。Apache 不会自动分析业务逻辑，但能靠配置实现高度可控的分层路由。
路径匹配顺序必须从具体到宽泛
Apache 的 ProxyPass 按配置文件中出现的**自上而下顺序匹配，一旦命中即终止后续规则**。若把兜底规则写在前面，所有请求都会被拦截，更细粒度的路径转发形同虚设。
-
错误写法（泛匹配优先）：
ProxyPass / http://fallback:3000/ProxyPass /api/ http://api:8000/→ 第二行永远不会生效 -
正确写法（精准优先）：
ProxyPass /admin/api/ http://admin-api:8080/ProxyPass /user/ http://user-svc:9000/ProxyPass /assets/ http://cdn:8081/ProxyPass / http://web-app:3000/
建议用 <Location> 块包裹，提升可读性与维护性，例如：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
<Location "/admin/api/"><br> ProxyPass http://admin-api:8080/<br> ProxyPassReverse http://admin-api:8080/<br></Location>
子路径代理必须保证前后斜杠一致
当把 /app/ 映射到后端根路径时，ProxyPass /app/ http://backend:8080/ 中两端的斜杠必须都存在且对齐。否则路径拼接会错乱：
-
/app/static/logo.png→ 被转发为http://backend:8080/app/static/logo.png（错误，多了/app） - ProxyPass /app/ http://backend:8080/ → 实际转发为
http://backend:8080/static/logo.png - http://backend:8080/myapp/），则应写成：
ProxyPass /app/ http://backend:8080/myapp/
前端资源 404？问题出在后端没适配 publicPath
浏览器加载 /app/static/app.js 时 404，通常不是 Apache 配置错了，而是后端返回的 HTML 中引用了相对路径（如 src="/static/app.js"），导致浏览器仍向 https://yourdomain.com/static/app.js 发起请求，而非 https://yourdomain.com/app/static/app.js。
- 解决方法：后端构建时设置
publicPath = "/app/"（Vue CLI）、homepage = "./app/"（Create React App）或等效配置 - Apache 需同步启用
ProxyPassReverse，确保重定向响应头中的 Location 被修正：ProxyPass /app/ http://backend:8080/ProxyPassReverse /app/ http://backend:8080/ - 静态资源可单独剥离，直接由 Apache 或 CDN 提供，避免走代理链路
WebSocket 和带协议升级的请求需额外支持
默认情况下，Apache 会丢弃 Upgrade: websocket 请求头，导致连接失败或 400 错误。
- 必须显式启用 WebSocket 代理：
ProxyPass /ws/ ws://backend:9000/ProxyPassReverse /ws/ ws://backend:9000/ - 配合重写规则确保 Upgrade 头透传：
RewriteEngine OnRewriteCond %{HTTP:Upgrade} =websocket [NC]RewriteRule /ws/(.*) ws://backend:9000/$1 [P,L] -
ws://协议必须小写；[P]表示代理，[L]表示终止规则链
