# Nginx Location 匹配规则
在 Nginx 中我们可以通过配置 location 指令块,来决定一个请求 url 如何处理。如果我们编写了多条 location 指令块,如何保证各个 location 不会产生冲突?如何理清 location 的匹配顺序?
带着这两个问题,我们先来做几道练习题。
# Nginx Location 小练习
问题 1、如果访问 /abcd 会匹配到哪个 config?
server {
location ~ /abc {
#config 1
}
location /abc {
#config 2
}
location ^~ /abc {
#config 3
}
}
2
3
4
5
6
7
8
9
10
11
12
13
问题 2、如果访问 /abcd 会匹配到哪个 config?
server {
location ~ /abc {
#config 1
}
location /abc {
#config 2
}
location ^~ /ab {
#config 3
}
}
2
3
4
5
6
7
8
9
10
11
12
13
问题 3、如果访问 /abcd 会匹配到哪个 config?
server {
location /abc {
#config 2
}
location ^~ /ab {
#config 3
}
}
2
3
4
5
6
7
8
9
如果这 3 道小练习让你很费解,那么我们就接着深入研究,相信你一定会有所收获,如果只想知道答案,请直接看文章末尾。
# Nginx location 配置语法
Nginx location 配置语法如下
location [ = | ~ | ~* | ^~ | 空 ] url { … }
其中 [ = | ~ | ~* | ^~ | 空 ] 表示 location 的修饰符,具体含义如下
- = 表示精准匹配(完全相等时,才会命中规则)。
- ~ 表示区分大小写的正则匹配。
- ~* 表示不区分大小写的正则匹配。
- ^~ 表示最佳匹配。
- 空,匹配以 url 开头的字符串,只能是普通字符串。
# Nginx location 的匹配过程
一般来说,一个 nginx.conf 文件通常会配置多个匹配规则,如果多个匹配规则都匹配到了 url,最终会执行哪一个呢?
1、Nginx 首先根据 url 检查最长匹配前缀字符串,即会判断【=】、【^~】、【空】修饰符定义的内容。
- 如果匹配到最长匹配前缀字符串。
- 如果最长匹配前缀字符串被【=】修饰符匹配,则立即响应。
- 如果没有被【=】修饰符匹配,则执行第 2 步判断。
- 如果没有匹配到最长匹配前缀字符串,则执行第 3 步判断。
2、Nginx 继续检查最长匹配前缀字符串,即判断【^~】、【空】修饰符定义的内容。
- 如果最长匹配前缀字符串被【^~】修饰符匹配,则立即响应。
- 如果被【空】修饰符匹配,则将该匹配保存起来,并执行第 3 步判断。
3、Nginx 找到 nginx.conf 中定义的所有正则匹配(~ 和 ~*),并按顺序进行匹配。
- 如果有任何正则表达式匹配成功,则立即响应。
- 如果没有任何正则匹配成功,则响应第 2 步中存储的【空】匹配。
小练习答案
问题 1:最长匹配字符串为 abc,且有 ^~ 匹配,故结果为:config3。
问题 2:最长匹配字符串为 abc,被【空】匹配,故会开始查询正则匹配,匹配到正则 ~ /abc,故结果为:config1。
问题 3:最长匹配字符串为 abc,被【空】匹配,故会开始查询正则匹配,没有匹配到任何正则,故使用【空】匹配到的结果:config2。
# 参考资料
Understanding Nginx Server and Location Block Selection Algorithms (opens new window)