【nginx】location 匹配规则总结

最新推荐文章于 2025-09-22 21:45:47 发布

原创最新推荐文章于 2025-09-22 21:45:47 发布 · 3.1k 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#openresty #nginx

nginx 专栏收录该内容

3 篇文章

订阅专栏

本文介绍了Nginx配置中location的语法和修饰符的优先级，包括精确匹配、前缀匹配和正则匹配。通过示例展示了不同修饰符下如何处理HTTP请求，并解释了在多个正则匹配时的查找顺序。同时，讲解了使用@定义命名location用于内部重定向，以及在处理错误页面时的应用。

1. 语法规则

语法规则，location关键字后面是可选的修饰符[ = | ~ | ~* | ^~ ]，后面是要匹配的字符串 uri，花括号中是要执行的操作。

2. 修饰符说明

匹配优先级为精确匹配 =， 其次前缀匹配 ^~，然后是正则匹配，再然后匹配不带任何修饰的前缀匹配。最后是交给 / 通用匹配。一旦匹配成功，则不再进行后续的匹配

2.1 示例

配置文件如下

    location = /files/index.html {
        echo 1 index;
    }

    location ^~ /files/ {
        echo 2 files;
    }

    location ~ .png$ {
        echo 3 png;
    }

    location ~* /(pic|img) {
        echo 4 pic;
    }

    location /api/v1 {
        echo 5 api;
    }

    location / {
        echo 6 default;
    }

请求 localhost/files/index.html 命中配置1，不再进行后续查找，返回 "1 index"
请求 localhost/files/bb.png 命中配置2，不再进行后续查找，返回 "2 files"
请求 localhost/pic/bb.png 命中配置3，不再进行后续查找，返回 "3 png"
请求 localhost/img/x.jpg 命中配置4，不再进行后续查找，返回 "4 pic"
请求 localhost//api/v1/users 命中配置5，，返回 " 5 api"
请求 localhost/home/page/dd 未匹配其他location，命中默认配置，返回 " 6 default"

2.2 同时命中多个正则匹配时的优先级

从上例可以看到，当localhost/pic/bb.png 同时匹配了两个正则location配置，即以pic或img目录开头，同时以png结尾。最终生效的是 .png$的配置。

交换两条配置的顺序，修改conf文件如下：

    location ~* /(pic|img) {
        echo 4 pic;
    }

    location ~ .png$ {
        echo 3 png;
    }

再次请求localhost/pic/bb.png，此时返回变为 "4 pic"

🎈结论：多个正则条件时，查找是按照在配置文件中的顺序进行的。

3. @的用法

@用来定义一个命名location。主要用于内部重定向，不暴露到正常的匹配流程中。可用于处理err_page

location / {
    try_files $uri $uri/ @not_found
}

location @not_found{
    echo file not found;
}