找回密码
 立即注册
首页 业界区 业界 nginx中的路径匹配规则详解(location规则) ...

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

慎气 2025-6-2 22:56:30
Nginx的路径匹配规则

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

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

优先级最高。当请求的URI与location后面的字符串完全相同时,Nginx会选择这个location块进行处理。(这个好理解,就是路径完全匹配,一模一样,优先级最高)
示例
  1. location = /favicon.ico {
  2.     # 处理/favicon.ico的请求
  3. }
复制代码
只有当请求URI严格为/favicon.ico时,上述location块才会被使用。
最长前缀匹配(^~)

第二优先级。请求的URI以某个location后面的字符串开头,并且这个字符串是最长的(或者使用了^~修饰符),Nginx会选择这个location块。但请注意,^~修饰符实际上会停止后续的正则匹配搜索。
示例
  1.    location ^~ /hello {
  2.      return  601;
  3.    }
  4.     location ^~ /hellow {
  5.      return  602;
  6.    }
  7.    location ^~ /hello/world {
  8.      return  603;
  9.    }
  10.     location ~ /hello {
  11.      return  604;
  12.    }
复制代码
对于请求/hello,满足 601和 604,实际返回601,就是因为^~优先级高于正则匹配;
对于请求/hellow,满足 601和 602,实际返回602,因为最长前缀匹配原则;
正则表达式匹配(~和~*)

第三优先级。正则表达式匹配允许定义更复杂的URI匹配模式。~表示区分大小写的正则匹配,而~*表示不区分大小写的正则匹配。
Nginx会按照配置文件中的顺序逐个检查正则表达式location块,直到找到第一个匹配的块。因此,正则表达式的顺序很重要。
示例:
  1. location ~ \.(gif|jpg|png)$ {
  2.     # 处理以.gif、.jpg或.png结尾的请求(区分大小写)
  3. }
  4. location ~* \.(GIF|JPG|PNG)$ {
  5.     # 处理以.GIF、.JPG或.PNG结尾的请求(不区分大小写)
  6. }
复制代码
对于请求/images/photo.jpg,第一个location块将被匹配(如果请求是区分大小写的)。
普通前缀匹配(无修饰符)

第四优先级。普通前缀匹配也按照配置文件中出现的先后顺序进行匹配,先出现的location指令优先匹配。
示例:
  1.    location /hello {
  2.      return  601;
  3.    }
  4.    location /hellow {
  5.      return  602;
  6.    }
复制代码
对于请求/hellow,满足 601和 602,实际返回602,证明满足长前缀匹配原则
默认匹配(/)

优先级最低。如果请求的URI与任何特定的location块都不匹配,Nginx将使用默认的location块(如果有的话)。通常,默认的location块是一个不带任何修饰符的location /块。
示例:
  1. location / {
  2.     # 处理所有其他请求
  3. }
复制代码
总结

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

  • 精确匹配(=)
  • 最长前缀匹配(^~),但会停止后续的正则匹配搜索
  • 正则表达式匹配(~和~*),按配置顺序
  • 普通前缀匹配(无修饰符),也按配置顺序
  • 默认匹配(/)
注意事项


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

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

相关推荐

您需要登录后才可以回帖 登录 | 立即注册