在 nginx 中编写 location 正则表达式需使用 ~(区分大小写)或 ~*(不区分大小写)修饰符,层级设计应遵循“精确匹配优先、前缀次之、正则最后”的原则,且一旦命中正则即停止后续搜索。具体做法是在 server 块内定义 location ~ ^/api/(.*)$ 这样的结构,将静态资源与动态请求分离,确保高频率的静态文件由前缀匹配快速处理,而复杂的 url 重写或 api 路由交给正则表达式处理。

如何区分大小写并捕获路径参数
区分大小写使用 ~,不区分使用 ~*;捕获组通过圆括号 () 实现,并在 rewrite 或 proxy_pass 中引用。例如 location ~ ^/images/(.*).jpg$ 可以捕获文件名部分,用于后续的重写逻辑或传递给后端服务。

server {
listen 80;
server_name example.com;
# 精确匹配,优先级最高
location = /favicon.ico {
log_not_found off;
access_log off;
}
# 前缀匹配,处理静态资源
location /static/ {
root /var/www/html;
expires 30d;
}
# 正则匹配,处理 API 请求
location ~ ^/api/v[0-9]+/(.*)$ {
# $1 捕获了 v1/users 中的 users
proxy_pass http://backend_api/$1;
}
}
正则匹配的执行顺序与冲突解决
Nginx 在处理 location 时,先进行所有前缀匹配的线性扫描以找到最长匹配,若未命中精确匹配则进入正则匹配阶段,按配置文件中的出现顺序执行第一个匹配的正则。如果多个正则同时匹配,只有第一个生效。为避免冲突,应将更具体的正则放在前面,或使用前缀匹配替代简单的正则判断。

# 测试用例:访问 /api/v1/test # 1. 检查 = /favicon.ico -> 不匹配 # 2. 检查 /static/ -> 不匹配 # 3. 检查 ~ ^/api/v[0-9]+/(.*)$ -> 匹配 # $1 = test # 执行 proxy_pass http://backend_api/test # 停止搜索
基于 proxy_pass 尾部斜杠的具体行为差异
当正则 location 中使用 proxy_pass 时,URL 是否包含尾部斜杠会直接影响传递给后端的路径。如果 proxy_pass 地址后无斜杠,Nginx 会将原始 URI 完整传给后端;如果有斜杠,Nginx 会用 proxy_pass 的地址替换匹配的部分。这一细节决定了后端应用接收到的路径是 /api/v1/test 还是 /test,需在配置时严格对应后端的路由定义。











