核心是用 rewrite ... last 实现内部重写，不改变浏览器地址栏；例如 location ^~ /v1/ { rewrite ^/v1/(.*)$ /$1 last; }，确保匹配优先级与兜底安全，支持灰度迁移和后端渐进升级。
在 Nginx 中通过 Rewrite 规则实现带版本号路径（如 /v1/api/users）到无版本号路径（如 /api/users）的平滑过渡，核心是用 rewrite 指令做内部重写，不改变浏览器地址栏，同时保持后端服务无需立即升级——这是灰度迁移、API 迭代时的常见需求。
明确重写目标与作用范围
先确认你要迁移的路径模式，比如：
- 所有
/v1/xxx→ 内部映射为/xxx - 仅匹配以
/v1/api/开头的请求 → 映射为/api/ - 保留查询参数、请求方法、请求体不变
关键点：用 rewrite ... last; 实现内部跳转，避免 301/302 重定向（否则地址栏会变，且对 POST 等方法不友好）。
基础 rewrite 写法（location 内）
在对应的 location 块中添加 rewrite 规则。例如：
location /v1/ {
rewrite ^/v1/(.*)$ /$1 last;
}
说明：
-
^/v1/(.*)$匹配以/v1/开头的完整 URI，捕获后面所有路径 -
/$1将捕获内容拼接到根路径下，实现去版本化 -
last表示重写后重新匹配 location，确保后续 proxy_pass 或静态文件处理能正确生效
⚠️ 注意：该规则需放在更具体的 location（如 location /v1/api/）之前，或使用 ^~ 前缀保证优先级，否则可能被通配 location 覆盖。
精准匹配 + 安全兜底（推荐生产用）
为避免误伤其他路径（如 /v10/ 或 /v1.2/），建议用更严格的正则，并配合 location ^~ /v1/ 提升匹配优先级：
location ^~ /v1/ {
# 只处理 /v1/ 开头、且后面紧跟 / 或字母数字的路径
rewrite ^/v1(/|$)(.*)$ $2 last;
# 或更稳妥：只重写 /v1/api/... 类路径
# rewrite ^/v1/(api/.*)$ /$1 last;
}
<h1>原有 v1 后端代理（可选：临时兼容旧路由）</h1><p>location /v1/api/ {
proxy_pass <a href="https://www.php.cn/link/bfe83751e041dbd12ee874dac9da466c">https://www.php.cn/link/bfe83751e041dbd12ee874dac9da466c</a>;
}</p>
这样既支持平滑过渡，又为未来彻底下线 v1 接口留出缓冲期。上线后可逐步将 proxy_pass 指向统一新服务，再删除 rewrite 规则。
验证与调试技巧
启用 Nginx 的 rewrite 日志快速定位问题：
http {
rewrite_log on; # 开启 rewrite 日志（需 debug 级日志）
error_log /var/log/nginx/rewrite.log notice;
}
然后用 curl -v http://your.domain/v1/api/users 查看日志中是否出现 rewrite 匹配和跳转过程。注意：rewrite_log 只在 debug 编译版中默认可用，生产环境建议先用 nginx -t 校验语法，再小流量验证行为。
