nginx rewrite核心是pcre正则匹配uri路径，需用^/$锚定、()捕获动态值、1+安全提取路径段，并注意rewrite仅处理路径不包含查询参数，避免循环重定向。/ ↩
正则表达式是 Nginx URL 重写的核心能力，匹配复杂网址结构的关键在于理解 URI 组成、掌握 PCRE 元字符含义，并精准控制锚点与捕获逻辑。
锚点与边界控制：避免误匹配
复杂路径常因缺少边界限制而匹配过宽。^ 和 $ 必须成对使用才能锁定完整 URI。
-
^/user/(\d+)/profile$ 只匹配
/user/123/profile，不匹配/user/123/profile/edit或/v1/user/123/profile - 若需兼容末尾斜杠，可写为 ^/user/(\d+)/profile/?$，其中
/?表示可选的斜杠 - 用 [^/]+ 替代
.*更安全——它表示“非斜杠的连续字符”，适合提取路径段，如/blog/post-abc123中的post-abc123
分组捕获与变量引用：透传动态值
括号 () 不仅用于逻辑分组，更是提取关键参数的手段，捕获内容通过 、 等引用。
-
^/api/v(\d+)/users/(\d+)$ → 重写为
/backend/v$1/users?id=$2，分别提取版本号和用户 ID - 嵌套结构可用非捕获组
(?:...)避免干扰编号，例如 ^/(?:en|zh|ja)/products/([a-z0-9\-]+)/?$，只捕获产品 slug，语言前缀不占 $1 - 多个可选参数组合时，用
(\w+)?或(?:&sort=\w+)?显式声明可选性，避免 .* 导致贪婪匹配越界
字符类与量词：应对真实路径变体
真实 URL 含字母、数字、短横线、下划线甚至中文（需 UTF-8 编码），需合理构造字符集。
-
^/article/([a-zA-Z0-9\u4e00-\u9fa5\-_]+)/?$ 支持中英文混合 slug，如
/article/如何配置-nginx - 日期类路径常用 \d{4}-\d{2}-\d{2}，比
[0-9]{4}-[0-9]{2}-[0-9]{2}更简洁；年份强制 4 位可防歧义 - 匹配带查询参数的原始请求？注意：rewrite 默认只处理 URI 路径部分（不含 ? 后参数）。如需保留参数，replacement 中直接写
$args，例如/new-path?$args
常见陷阱与规避建议
复杂匹配容易引发循环重定向或规则失效，需主动防御。
- 避免在 location 块内无条件使用
last，尤其当 replacement 仍可能命中当前 location 时——改用break或移至 server 级 - 含多个 rewrite 的场景，按从具体到宽泛排序，否则宽泛规则会提前截断后续匹配
- 调试时加
error_log /var/log/nginx/rewrite.log notice;并用rewrite_log on;查看实际匹配过程 - 对高并发路径，优先考虑用
location ~ ^/api/+proxy_pass替代 rewrite，性能更优且逻辑更清晰
