Nginx——location匹配与在配置中的优先级

1. location表达式类型

location ^~ /api/v7/ {
   proxy_next_upstream http_404 http_500 http_502 http_503 http_504  error timeout invalid_header;
   proxy_set_header  Connection "keep-alive";
   proxy_set_header X-Real-IP $remote_addr;
   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   proxy_pass http://www.hello.world;
   proxy_set_header tenant-id $tenantId;
}   

上面是一个location匹配的例子，实际上，location匹配表达式还有多种：

• ~ 表示执行一个正则匹配，区分大小写
• ~* 表示执行一个正则匹配，不区分大小写
• ^~ 表示普通字符匹配。使用前缀匹配。如果匹配成功，则不再匹配其他location。
• = 进行普通字符精确匹配。也就是完全匹配。
• @ "@" 定义一个命名的 location，使用在内部定向时，例如 error_page, try_files
• / 通用匹配, 如果没有其它匹配,任何请求都会匹配到

2. location优先级说明

在nginx的location和配置中location的顺序没有太大关系。与location表达式的类型有关。相同类型的表达式，字符串长的会优先匹配。
以下是按优先级排列说明：
第一优先级：等号类型（=）的优先级最高。一旦匹配成功，则不再查找其他匹配项。
第二优先级：^~类型表达式。一旦匹配成功，则不再查找其他匹配项。
第三优先级：正则表达式类型（~ ~*）的优先级次之。如果有多个location的正则能匹配的话，则使用正则表达式最长的那个。
第四优先级：常规字符串匹配类型。按前缀匹配。

#顺序不等于优先级
(location =) > (location 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (/)

3. location优先级示例

配置项如下:

location = / {
　　# 精确匹配 / ，主机名后面不能带任何字符串
　　[ configuration A ]
}
location / {
　　# 因为所有的地址都以 / 开头，所以这条规则将匹配到所有请求
　　# 但是正则和最长字符串会优先匹配
　　[ configuration B ]
}
location /documents/ {
　　# 匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索
　　# 只有后面的正则表达式没有匹配到时，这一条才会采用这一条
　　[ configuration C ]
}
location ~ /documents/Abc {
　　# 匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索
　　# 只有后面的正则表达式没有匹配到时，这一条才会采用这一条
　　[ configuration CC ]
}
location ^~ /images/ {
　　# 匹配任何以 /images/ 开头的地址，匹配符合以后，停止往下搜索正则，采用这一条。
　　[ configuration D ]
}
location ~* \.(gif|jpg|jpeg)$ {
　　# 匹配所有以 gif,jpg或jpeg 结尾的请求
　　# 然而，所有请求 /images/ 下的图片会被 config D 处理，因为 ^~ 到达不了这一条正则
　　[ configuration E ]
}
location /images/ {
　　# 字符匹配到 /images/，继续往下，会发现 ^~ 存在
　　[ configuration F ]
}
location /images/abc {
　　# 最长字符匹配到 /images/abc，继续往下，会发现 ^~ 存在
　　# F与G的放置顺序是没有关系的
　　[ configuration G ]
}
location ~ /images/abc/ {
　　# 只有去掉 config D 才有效：先最长匹配 config G 开头的地址，继续往下搜索，匹配到这一条正则，采用
　　[ configuration H ]
}

请求匹配示例

/ -> config A  #精确完全匹配，即使/index.html也匹配不了
/downloads/download.html -> config B    #匹配B以后，往下没有任何匹配，采用B
/images/1.gif -> configuration D   # 匹配到F，往下匹配到D，停止往下
/images/abc/def -> config D  #最长匹配到G，往下匹配D，停止往下   
　　　　　　　　　　　　　　　　   可以看到 任何以/images/开头的都会匹配到D并停止，FG写在这里是没有任何意义的，H是永远轮不到的，这里只是为了说明匹配顺序
/documents/document.html -> config C    #匹配到C，往下没有任何匹配，采用C
/documents/1.jpg -> configuration E     #匹配到C，往下正则匹配到E
/documents/Abc.jpg -> config CC    #最长匹配到C，往下正则顺序匹配到CC，不会往下到E

参考：https://www.bo56.com/nginx-location%E5%9C%A8%E9%85%8D%E7%BD%AE%E4%B8%AD%E7%9A%84%E4%BC%98%E5%85%88%E7%BA%A7/