在 nginx 中实现旧链接平滑迁移到新路径，核心做法是利用 rewrite 指令配合正则表达式捕获组，将请求的 uri 重新映射到目标地址。通过设置合适的重定向状态码（如 301 永久或 302 临时），浏览器和搜索引擎能正确更新索引并跳转至新路径。若需保留查询参数，应在替换字符串末尾添加 $query_string 变量。
如何配置基础的正则匹配与重定向规则
直接回答：使用 location 块结合 ~ 修饰符启用正则匹配，并通过 rewrite 指令定义源模式与目标模式。例如，将 /old/ 开头的请求迁移到 /new/，只需在 server 块中添加相应的 rewrite 规则即可生效。
server {
listen 80;
server_name example.com;
# 基础迁移规则：将 /old/path 重定向到 /new/path
location /old/ {
rewrite ^/old/(.*)$ /new/$1 permanent;
}
# 处理带查询参数的情况
location /api/v1/ {
rewrite ^/api/v1/(.*)$ /api/v2/$1?$query_string last;
}
}
上述配置中，permanent 关键字对应 HTTP 301 状态码，表示永久移动；last 关键字对应内部重定向，不改变浏览器地址栏。对于 API 版本升级场景，通常建议使用 last 以保持透明性，而前端页面迁移推荐使用 permanent 以利于 SEO。
如何处理复杂路径结构与遗留参数
直接回答：当旧链接包含多层嵌套或特定参数时，需在正则表达式中使用多个捕获组，并在替换字符串中按顺序引用。同时，可以通过 if 指令或更复杂的 location 优先级来控制特定条件的重写行为，确保非目标请求不被误伤。
server {
listen 80;
server_name example.com;
# 复杂路径迁移：/blog/2023/post-id 到 /news/post-id
location ~ ^/blog/(\d{4})/(.+)$ {
rewrite ^/blog/\d{4}/(.+)$ /news/$1 last;
}
# 排除特定文件类型，避免静态资源被错误重写
location ~* \.(jpg|png|css|js)$ {
expires 30d;
try_files $uri =404;
}
}
该示例展示了如何从日期归档结构迁移到扁平化结构。正则 ^/blog/(\d{4})/(.+)$ 捕获年份和文章 ID，但替换规则中仅使用了第二个捕获组 $1（即文章 ID），从而丢弃了年份部分。注意，try_files 用于确保静态资源直接由 Nginx 服务，不经过重写逻辑，避免性能损耗和循环重定向。
基于具体输入验证重定向链是否形成死循环
直接回答：通过构造包含新旧路径混合的请求，检查 Nginx 是否陷入无限重定向循环。关键在于确认重写后的 URI 不再匹配任何 rewrite 规则，或者命中了终止标志（如 break 或 return）。若发现循环，需调整正则边界或增加例外条件。
# 测试用例：访问 /old/test # 预期结果：301 跳转到 /new/test # 若配置错误导致 /new/test 再次被重写，则出现 500 错误 # 验证脚本（curl） curl -I http://example.com/old/test # 输出应包含：HTTP/1.1 301 Moved Permanently # Location: http://example.com/new/test # 验证新路径是否可正常访问 curl -I http://example.com/new/test # 输出应包含：HTTP/1.1 200 OK
在实际部署前，务必使用 curl -I 或浏览器开发者工具的网络面板监控响应头。重点观察 Location 字段的变化，确保其指向最终目标而非中间节点。若 Location 反复切换，说明存在规则冲突或递归调用，需审查 location 块的优先级和 rewrite 的 last/break 标记。
