Nginx多级目录迁移URL重写需精准捕获路径并映射，用^$锁定完整匹配、合理选flag、避免循环；示例：rewrite ^/blog/v2/article/(\d+)$ /posts/$1 permanent; 复杂结构可用多组括号捕获重组。
多级目录迁移时，Nginx URL 重写的核心是精准捕获原路径结构，并按新层级映射替换，同时注意 flag 的选择、正则边界控制和潜在循环风险。
明确匹配范围，避免误伤其他路径
多级目录（如 /blog/v2/article/123 → /posts/123）容易与根路径、静态资源或 API 路径冲突。必须用 ^ 和 $ 锁定完整路径起止，防止部分匹配引发意外跳转。
- ✅ 推荐写法：
rewrite ^/blog/v2/article/(\d+)$ /posts/$1 permanent; - ❌ 风险写法：
rewrite /article/(\d+) /posts/$1 permanent;（可能误匹配/myarticle/123或/api/article/123）
逐层提取变量，支持复杂结构调整
当新旧目录层级差异大（如 /a/b/c/d.html → /content/d?section=a&sub=b&type=c），可利用多个括号捕获各段，再在 replacement 中重组。
- 示例：
rewrite ^/([a-z]+)/([a-z]+)/([a-z]+)/([^.]+)\.html$ /content/$4?section=$1&sub=$2&type=$3 permanent; - 注意：每个
()捕获的内容按顺序对应$1、$2…；特殊字符如.需转义为\. - 若某段可选（如
/v1/a/b和/a/b都要兼容），可用(?:v\d+/)?非捕获组或(v\d+/)?可选捕获（注意空值处理）
慎用 last 与 break，区分重写后是否重新匹配 location
多级迁移常涉及跨 location 处理（如旧路径在 location /blog/，新路径需交由 PHP 或代理处理）。flag 决定后续流程：
- permanent 或 redirect：直接返回 301/302，客户端跳转，不走后续 Nginx 匹配——适合对外暴露的新地址
-
last：内部重写后，用新 URI 重新查找 location 块（如从
location /blog/跳到location /posts/）——适合同站内路径调整 - break：重写后停止所有 rewrite 指令，且不再进入 location 匹配，直接尝试访问文件或 fallback——适合静态资源映射，但易 404
测试与防护：避免循环和 500 错误
Nginx rewrite 循环上限为 10 次，多级规则叠加易触发。上线前务必验证：
- 用
curl -I检查响应头中的Location是否符合预期，状态码是否为 301/302 - 确认新路径对应的
location块存在且配置正确（如 PHP 处理、proxy_pass 等） - 在 if 块中使用 rewrite 要格外小心，优先考虑用
try_files替代if (!-e $request_filename)类逻辑 - 生产环境建议加日志：
error_log /var/log/nginx/rewrite.log notice;，配合rewrite_log on;（仅调试启用）
