nginx location匹配顺序

浅浅的花香味﹌ 2023-06-15 06:53 11阅读 0赞

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 ] 
    }
    
    location ~* /js/.*/\.js

已 `=` 开头表示精确匹配 ,如 A 中只匹配根目录结尾的请求，后面不能带任何字符串。
    `^~` 开头表示uri以某个常规字符串开头，不是正则匹配
    `~` 开头表示区分大小写的正则匹配;
    `~*` 开头表示不区分大小写的正则匹配
    `/` 通用匹配, 如果没有其它匹配,任何请求都会匹配到

优先级：

(location `=` ) > (location `完整路径` ) > (location `^~` 路径) > (location `~`,`~*` 从上向下正则顺序，匹配在最后一条终止) > (location 部分起始路径) > (`/`)

![format_png][]

上面的匹配结果  
按照上面的location写法，以下的匹配示例成立：

/ -> 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

## 分类: ##

正则location和普通location
    
    正则location  “~”和“~*”：“~”表示区分大小写；“~*”表示不区分大小写
    
    普通location:  除了上面其余全是(包括没有前缀) “=”，“^~”，“@”
    
    “^~”中的“^”表示非，“~”表示正则，意思为不要继续匹配正则
    
    “=”也表示阻止正则location，和“^~”的区别为：“^~”依然遵守“最大前缀”匹配；而“=”必须是严格匹配。
    
    “@ ”是用来定义“Named Location ”的（可以理解为独立于“普通location”和“正则location”之外的第三种类型），这种“Named Location ”不是用来处理普通的HTTP 请求的，它
    
    是专门用来处理“内部重定向（internally redirected ）”请求的。
    
    注意：这里说的“内部重定向（internally redirected ）”是不需要跟浏览器交互的，纯粹是服务端的一个转发行为。

## 匹配顺序 ##

匹配顺序总结为以下两点：

1.匹配的顺序是先匹配普通字符串，然后再匹配正则表达式。另外普通字符串匹配顺序是根据配置中字符长度从长到短，也就是说使用普通字符串配置的location顺序是无关紧要的，反正最后nginx会根据配置的长短来进行匹配，但是需要注意的是正则表达式按照配置文件里的顺序测试。找到第一个匹配的正则表达式将停止搜索。
    
    2.一般情况下，匹配成功了普通字符串location后还会进行正则表达式location匹配。有两种方法改变这种行为，其一就是使用“=”前缀，这时执行的是严格匹配，并且匹配成功后立即停止其他匹配，同时处理这个请求；另外一种就是使用“^~”前缀，如果把这个前缀用于一个常规字符串那么告诉nginx 如果路径匹配那么不测试正则表达式。

## 注意事项 ##

1.nginx匹配顺序是先匹配普通location，在匹配正则location；
    
    2.普通匹配规则无顺序无论写在配置文件的那个地方都一样，但是正则匹配则是按照匹配配置文件中由上到下的先后顺序匹配；

[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy81OTQxMjU1LWExNGQ1YWVhNjhhODY4MTAucG5n?x-oss-process=image/format,png