nginx微服务网关中路径前缀裁剪靠proxy_pass末尾斜杠与location前缀配合自动完成：location /api/v1/ { proxy_pass http://user-svc:8080/; }将/api/v1/profile转为/profile；动态版本需正则+rewrite；务必透传x-original-uri等原始信息。
要让 Nginx 在微服务网关中统一裁剪请求路径前缀（比如把 /api/v1/users 转成 /users 发给后端），关键不是“手动删掉”，而是靠 proxy_pass 末尾斜杠与 location 前缀的配合自动完成裁剪。配置对了，Nginx 会自动剥离匹配部分，只转发剩余路径。
用带尾斜杠的 proxy_pass 实现标准裁剪
这是最常用、最可靠的方式。只要 location 和 proxy_pass 都以 / 结尾，Nginx 就会把整个 location 匹配前缀去掉，只拼接剩余路径。
-
location /api/v1/ { proxy_pass http://user-svc:8080/; }
→ 请求/api/v1/profile→ 后端收到/profile -
location /admin/ { proxy_pass http://admin-svc/; }
→ 请求/admin/logs?from=2026→ 后端收到/logs?from=2026 - 注意：
location必须精确匹配前缀，避免误截（如写location /api可能匹配/api123）
多版本路径需动态裁剪时用正则 + rewrite
当路径结构不固定（比如 /v1/users、/v2/products），无法用静态前缀匹配时，必须用正则 location，并显式 rewrite 裁剪。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
location ~ ^/v(?<ver>\d+)/(?<path>.*)$ { rewrite ^/v\d+/(.*)$ /$1 break; proxy_pass http://backend-svc/; }</path></ver>-
break确保重写后不再重新匹配 location，直接走当前块的proxy_pass - 捕获组
$1必须与正则括号严格对应，否则可能转发空路径
统一裁剪后别忘了透传原始信息
裁剪只是改了路径，后端仍需知道原始请求上下文，否则日志、重定向、鉴权都可能出错。
- 加
proxy_set_header X-Original-URI $request_uri;透传完整原始路径 - 保留真实 Host：
proxy_set_header Host $host; - 传递客户端 IP：
proxy_set_header X-Real-IP $remote_addr;和X-Forwarded-For $proxy_add_x_forwarded_for; - 如果后端返回 302 重定向，且 Location 是内部地址，要用
proxy_redirect重写，例如：proxy_redirect http://localhost:8080/ /;
避免常见裁剪错误
裁剪失效或路径错乱，往往是因为几个细节没对齐：
-
proxy_pass http://svc（无尾斜杠）→ 不裁剪，原样拼接，/api/v1/user会变成/api/v1/user发过去 -
location /api/ { proxy_pass http://svc/v1/; }→ 会把/api/替换成/v1/，结果是/v1/user，不是裁剪而是替换 - 正则 location 中
proxy_pass后不能带路径（包括结尾/），否则配置加载失败 - 不要在
proxy_pass里拼变量路径（如http://$svc/$prefix），易引发 SSRF 或空值问题；应先rewrite或用map控制
