Nginx Location匹配规则的具体使用_Linux

1. 语法基础

nginx 的 location 指令的基本语法如下：

location [=|~|~*|^~|@] uri { ... }

= 表示精确匹配。
~ 表示区分大小写的正则匹配。
~* 表示不区分大小写的正则匹配。
^~ 表示非正则匹配，如果该选项匹配，则不再进行正则匹配。（ ^ 表示“非”，~ 表示“正则”，字符意思是：不会继续匹配正则）
@ 定义一个命名的 location，通常用于内部重定向。

2. 匹配规则

nginx 对多个 location 的匹配遵循一定的规则和优先级。当 nginx 收到一个请求时，它会按照以下顺序进行匹配

2.1 精确匹配（=）

优先级最高。当请求的uri与location后面的字符串完全相同时，nginx会选择这个location块进行处理。(这个好理解，就是路径完全匹配，一模一样，优先级最高)

示例：

location = /favicon.ico {
    # 处理/favicon.ico的请求
}

只有当请求uri严格为/favicon.ico时，上述location块才会被使用。

2.2. 最长前缀匹配（^~）

以^~开头的location表示最长前缀匹配。如果请求的uri以某个location后面的字符串开头，并且这个字符串是最长的（或者使用了^~修饰符），nginx会选择这个location块。但请注意，^~修饰符实际上会停止后续的正则匹配搜索。（最长前缀匹配，意思就是以location后面的字符开始的且最长匹配，有的地方叫做非正则匹配，意思是满足了最长前缀匹配，就不会再匹配正则匹配了，也可以理解为即满足最长前缀匹配，也满足正则匹配，就匹配最长前缀匹配，也就是所说的最长前缀匹配优先级高于正则匹配，所谓的优先级是两者或多着都匹配的情况下，才会显现优先级）

示例：

   location ^~ /hello {
     return  601;
   }

    location ^~ /hellow {
     return  602;
   }

   location ^~ /hello/world {
     return  603;
   }

    location ~ /hello {
     return  604;
   }

对于请求/hello，满足 601和 604，实际返回601，就是因为^~优先级高于正则匹配；
对于请求/hellow，满足 601和 602，实际返回602，因为最长前缀匹配原则；

2.3. 正则表达式匹配（~和~*）

正则表达式匹配允许定义更复杂的uri匹配模式。~表示区分大小写的正则匹配，而~*表示不区分大小写的正则匹配。

nginx会按照配置文件中的顺序逐个检查正则表达式location块，直到找到第一个匹配的块。因此，正则表达式的顺序很重要。

示例：

location ~ \.(gif|jpg|png)$ {
    # 处理以.gif、.jpg或.png结尾的请求（区分大小写）
}
location ~* \.(gif|jpg|png)$ {
    # 处理以.gif、.jpg或.png结尾的请求（不区分大小写）
}

对于请求/images/photo.jpg，第一个location块将被匹配（如果请求是区分大小写的）。

2.4. 普通前缀匹配（无修饰符）

普通前缀匹配也按照配置文件中出现的先后顺序进行匹配，先出现的location指令优先匹配。

示例：

   location /hello {
     return  601;
   }

   location /hellow {
     return  602;
   }

对于请求/hellow，满足 601和 602，实际返回602，证明满足长前缀匹配原则

再增加一项配置
```
  location ~ /hello[a-z] {
          return  603;
  }
```

对于请求/hellow，满足 601、 602和603，实际返回603，证明正则匹配优先级高于普通匹配

2.5. 默认匹配（/）

如果请求的uri与任何特定的location块都不匹配，nginx将使用默认的location块（如果有的话）。通常，默认的location块是一个不带任何修饰符的location /块。

示例：

location / {
    # 处理所有其他请求
}

综上所述

nginx的location匹配规则优先级可以总结为：

精确匹配（=）
最长前缀匹配（^~），但会停止后续的正则匹配搜索
正则表达式匹配（~和~*），按配置顺序
普通前缀匹配（无修饰符），也按配置顺序
默认匹配（/）

3. 注意事项

正则匹配与顺序：正则 location 的匹配顺序很重要，因为 nginx 会按照配置文件中定义的顺序进行匹配。
proxy_pass 的路径替换：在配置 proxy_pass 时，需要注意 location 后面的 uri 是否包含斜杠（/），这会影响请求的转发路径。通常建议 location 和 proxy_pass 要么都加斜杠，要么都不加。
性能优化：将精确匹配放在前面，可以减少不必要的正则匹配，提高 nginx 的处理效率。

4. 常见的正则符号

符号	描述	示例
`^`	匹配字符串的开始位置	`^http` 匹配以"http"开头的字符串
$	匹配字符串的结束位置	`\.com$` 匹配以".com"结尾的字符串
`.`	匹配除换行符以外的任意单个字符	`a.c` 匹配"abc"、"a1c"等
`*`	匹配前面的子表达式零次或多次	`ab*c` 匹配"ac"、“abc”、"abbc"等
`+`	匹配前面的子表达式一次或多次	`ab+c` 匹配"abc"、“abbc”、“abbbc"等，但不匹配"ac”
`?`	匹配前面的子表达式零次或一次	`ab?c` 匹配"ac"、“abc”
\|	或匹配模式，匹配左边的表达式或右边的表达式	`(jpg\|gif\|png)` 匹配"jpg"、“gif"或"png”
`\`	转义字符，用于匹配特殊字符	`\.` 匹配"."字符本身
`[ ]`	字符集合，匹配集合中的任意单个字符	`[a-z]` 匹配任意小写字母
`[^ ]`	反向字符集合，匹配不在集合中的任意单个字符	`[^a-z]` 匹配任意非小写字母
`{n}`	n 是一个非负整数，匹配确定的 n 次	`o{2}` 匹配"oo"
`{n,}`	n 是一个非负整数，至少匹配 n 次	`o{2,}` 匹配"oo"、“ooo”、"oooo"等
`{n,m}`	n 和 m 均为非负整数，其中n <= m，匹配至少 n 次，但不超过 m 次	`o{2,4}` 匹配"oo"、“ooo”、“oooo”