nginx中的路径匹配规则详解(location规则)

Nginx的路径匹配规则

Nginx的匹配规则用location指令来实现,Nginx 的location指令用于匹配请求的 URI(请求路径),并根据匹配结果执行特定的处理指令。location是实现动静分离、URL 重写、反向代理等功能的核心模块之一.

location匹配规则分类

location支持多种匹配模式,包括精确匹配、前缀匹配、正则匹配等

精确匹配(=

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

示例

复制代码
location = /favicon.ico {
    # 处理/favicon.ico的请求
}

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

最长前缀匹配(^~

第二优先级 。请求的URI以某个location后面的字符串开头,并且这个字符串是最长的(或者使用了^~修饰符),Nginx会选择这个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,因为最长前缀匹配原则;

正则表达式匹配(~~*

第三优先级 。正则表达式匹配允许定义更复杂的URI匹配模式。~表示区分大小写的正则匹配,而~*表示不区分大小写的正则匹配。

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

示例:

复制代码
location ~ \.(gif|jpg|png)$ {
    # 处理以.gif、.jpg或.png结尾的请求(区分大小写)
}
location ~* \.(GIF|JPG|PNG)$ {
    # 处理以.GIF、.JPG或.PNG结尾的请求(不区分大小写)
}

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

普通前缀匹配(无修饰符)

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

示例:

复制代码
   location /hello {
     return  601;
   }

   location /hellow {
     return  602;
   }

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

默认匹配(/

优先级最低 。如果请求的URI与任何特定的location块都不匹配,Nginx将使用默认的location块(如果有的话)。通常,默认的location块是一个不带任何修饰符的location /块。

示例:

复制代码
location / {
    # 处理所有其他请求
}

总结

Nginx的location匹配规则优先级可以总结为:

  • 精确匹配(=

  • 最长前缀匹配(^~),但会停止后续的正则匹配搜索

  • 正则表达式匹配(~~*),按配置顺序

  • 普通前缀匹配(无修饰符),也按配置顺序

  • 默认匹配(/

注意事项

  • 正则匹配与顺序:正则 location 的匹配顺序很重要,因为 Nginx 会按照配置文件中定义的顺序进行匹配。

  • proxy_pass 的路径替换:在配置 proxy_pass 时,需要注意 location 后面的 URI 是否包含斜杠(/),这会影响请求的转发路径。通常建议 location 和 proxy_pass 要么都加斜杠,要么都不加。

  • 性能优化:将精确匹配放在前面,可以减少不必要的正则匹配,提高 Nginx 的处理效率。