nginx location匹配规则-location匹配优先级

location语法

【语法示例】location [=|~|~*|^~] /uri/ { … }

= 开头表示精确匹配

^~ 开头表示uri以某个常规字符串开头，理解为匹配 url路径即可。nginx不对url做编码，因此请求为/static/20%/aa，可以被规则^~ /static/ /aa匹配到（注意是空格）。

~ 开头表示区分大小写的正则匹配

~* 开头表示不区分大小写的正则匹配

!~和!~*分别为区分大小写不匹配及不区分大小写不匹配的正则

/ 通用匹配，任何请求都会匹配到。

1、精准匹配和一般匹配

#规则1
location = /zg/ {
    root   html;
    index  index.html;
}
#规则2
location /zg/ {
    root   html;
    index  index2.html;
}

请求URL：http://192.0.0.1/zg/ 访问时匹配的是规则1，也就是：location = /zg/ {}

2、精准匹配和一般匹配，uri后面不带“/”匹配

#规则1
location = /zg {
    root   html;
    index  index.html;
}
#规则2
location /zg {
    root   html;
    index  index2.html;
}

请求URL：http://192.0.0.1/zg/ 访问时匹配的是规则2，也是是：location /zg {}

3、精准匹配和一般匹配，uri前面和后面都不带“/”

#规则1
location = zg {
    root   html;
    index  index.html;
}
#规则2
location zg {
    root   html;
    index  index2.html;
}

请求URL：http://192.0.0.1/zg/ 访问时匹配的是：= zg

4、精准匹配和一般匹配，uri带"/"和不带"/"匹配

#规则1
location = zg {
    root   html;
    index  index.html;
}
#规则2
location zg {
    root   html;
    index  index2.html;
}
#规则3
location /zg/ {
    root   html;
    index  index2.html;
}

请求URL：http://192.0.0.1/zg/ 访问时匹配的是：/zg/

综上所述：路径相同时的精准匹配优先，必须是满足/uri/或者uri，要么uri两边都加/，要么uri两边都不加斜杆的情况

5、一般匹配时的匹配规则

#规则1
location /images/ {
    root   html/file;
}
#规则2
location /images/aa {
    root   html/file2;
}

在html下创建file,file2文件夹，然后在file下创建images文件夹，在images下创建aa文件夹，在file2下创建images文件夹，接着在images下创建aa文件夹，然后同时在两个aa文件夹下导入test.jpg图片，这样file和file2下都有images/aa路径

请求url：http://192.0.0.1/images/aa/test.jpg，既能匹配/images/,又能匹配/images/aa，这时以最长uri匹配优先，匹配的是：/images/aa

6、^~开头的非正则匹配和一般匹配

^~代表非正则匹配，非正则，不需要继续正则匹配。

#规则1
location ^~/images/ {
    root   html/file;
}
#规则2
location /images/aa {
    root   html/file2;
}

^~:如果这个匹配使用^〜前缀，搜索停止。这个前缀官网和网上都说得很含糊，加上这个前缀，是会停止搜索正则匹配，但是对一般匹配是不会停止的，也就是说还是可以匹配到一般匹配的。

请求url： http://192.0.0.1/images/aa/test.jpg，匹配结果：/images/aa/

7、^~开头的非正则匹配和正则匹配

~ 开头表示区分大小写的正则匹配

#规则1
location ^~/images/ {
    root   html/file;
}
#规则2
location ~/images/aa {
    root   html/file2;
}

请求url： http://192.0.0.1/images/aa/test.jpg，匹配结果：^~/images/

【个人理解】因为已经匹配到了^~/images/，因为使用^~后会停止搜索正则匹配，所以即使~/images/aa更精准也不能再被匹配到，因为正则匹配的搜索已经停止。这个示例和大小写没有关系。

8、严格精准匹配和正则匹配

#规则1
location / {
    root   html;
    index index.html;
    deny all;
}
#规则2
location ~\.html$ {
    allow all;
}

严格精准匹配，如果被严格精准匹配到了，则不会继续搜索正则匹配

如果http://192.0.0.1,这个就严格精准匹配到了 /,则不会继续匹配 ~ \.html$

如果：http://192.0.0.1/index.html，则会被/ 匹配到，但是不是严格精准匹配，则会继续搜索正则匹配

9、正则匹配规则

都是正则uri的情况下，匹配是按照编辑顺序的#规则1

location ~\.html$ {
    allow all;
}
#规则2
location ~^/prefix/.*\.html$ {
    deny all;
}

请求URL：http://192.0.0.1/prefix/index.html，会优先匹配前面定义的location。

10、@开头的uri

error_page 404 = @fallback;
location @fallback{
    proxy_pass http://www.baidu.com
}

@开头的，如果请求的 URI 存在，则本 nginx 返回对应的页面；如果不存在，则把请求代理到baidu.com 上去做个弥补，其实就是做了一个容错，把找不到的url全部转发到fallback的反向代理服务器去。

最后总结

先判断精准命中，如果命中，立即返回结果并结束解析过程
判断普通命中，如果有多个命中，记录下来最长的命中结果
如果是^~开头的命中，则不会继续搜索正则命中，但是会继续搜索一般命中
继续判断正则表达式的解析结果，按配置里的正则表达式顺序为准，由上到下开始匹配，一旦匹配成功立刻返回结果，并结束解析过程。

延伸分析

a. 普通命中：顺序无所谓，是因为按命中长短来确定的

b. 正则命中：顺序有所谓，因为是从前往后命中的