一文讲清楚Nginx location匹配优先级规则

    Nginx 配置文件中的「server」模块下的子模块 「location」包含了一套与请求 URI 进行匹配的规则，以及「location」匹配成功后的处理逻辑，例如：返回服务器端的静态文件或者实现跳转等功能，可以实现 Nginx 的“动静分离”和“反向代理”等核心功能，所以正确理解「location」匹配规则是非常重要的。以下是Nginx官方文档和翻译文档对「location」模块的解释：

• 核心模块：Module ngx_http_core_module
• 翻译内容：ngx_http_core_module 模块

一. 语法规则：

location [=|~|~*|^~] /uri/ { … }   //红色方框里面的参数为可选项，括号里为指令集

    假如 nginx 现在接受到一个 URL 请求：http://www.example.com/static/img/logo.jpg， 这里需要注意，URL从第一个单斜杠后的内容才是「URI」内容：/static/img/logo.jpg，那么location匹配的原理就是用截取的「URI」和location表达式进行匹配和定位，并执行location模块内部的指令集。

一个「location」表达式可以使用「前缀字符串」- prefix string, 或「正则表达式」- regular expression 来定义。

1. 「前缀字符串」：以 = （精确匹配）或 ^~  修饰符开头或者不带任何修饰符的字符串

location = /static/img/logo.jpg {...}

location ^~ /static/img/logo.jpg {...}

location /static/img/logo.jpg {...}

2.  「正则表达式」：以“~*”(不区分大小写)，或者“~”(区分大小写)修饰符开头，例如：下面的正则表达式匹配的是以“gif|jpg|jpeg” 文件后缀名结尾的所有URI，\. 代表文件后缀名。

location ~* \.(gif|jpg|jpeg)$ {...}

location ~ \.(gif|jpg|jpeg)$ {...}

二. 匹配规则

• nginx 首先匹配以「前缀字符串」定义的location，找到匹配成功的最长的前缀字符串，并且记录下来，然后继续匹配「正则表达式」定义的location（按照配置文件里locaton块定义的顺序依次进行匹配）如果匹配成功，则终止匹配。
• 如果「正则表达式」没有匹配成功，则采用之前记录的匹配成功的最长「前缀字符串」的location.
• 如果匹配成功的最长「前缀字符串」含有“^~”修饰符，则终止匹配，即不再继续匹配「正则表达式」定义的location路径。
• 如果location 含有“=”字符，并且与请求的URI精确匹配成功，则终止匹配。

三. 匹配实例

请求URL案例分析：http://www.example.com/static/img/logo.jpg

该请求的URI部分：/static/img/logo.jpg

1. 如果「前缀字符串」定义的location与请求URI“精确匹配”成功，则终止匹配。

location = /static/img/logo.jpg {

}

2. 如果有多个「前缀字符串」匹配成功，则“记住”最长的前缀匹配，即本例中的 /static/img/，并继续检测「正则表达式」匹配。

location /static/ {

}

location /static/img/ {

}

3. 如果匹配成功的最长「前缀字符串」含有“^~”修饰符，则终止匹配。

location /static/ {

}

location ^~ /static/img/ {

}

4. 如果有多个「正则表达式」匹配成功，则放弃上述 2 中的最长前缀匹配，使用第一个匹配成功的正则匹配，即本例中的 location ~* /static/ ，并终止匹配。

location /static/ {

}

location /static/img/ {

}

location ~* /static/ {

}

location ~* /static/img/ {

}

5. 如果没有「正则表达式」满足匹配，则采用 “步骤2” 中记住的最长前缀匹配, 即：本例中的location /static/img/ 。

location /static/ {

}

location /static/img/ {

}

location ~* /video/ {

}

6.  通配规则: location / 可以匹配任何请求，如果未匹配到其他的location，则执行本例中的location /。可以将通配规则理解为 swith case 语句里面的 default 分支。

location / {

}

location /video/ {

}