详细分析：Nginx 的 location 匹配优先级

Nginx 处理请求时，会按特定优先级匹配location规则，优先级从高到低为：

• location = /index.html {} 精确匹配, 匹配成功不再匹配其他项
• location ^~ /path/ {} 前缀匹配, 匹配成功不再匹配其他项
• location ~ 正则(区分大小写) {} 或 location ~* 正则(不区分大小写) {} 多个会匹配最长的
• location /path/ {} 普通前缀匹配, 多个会匹配最长的
• location / {}（默认匹配，所有未被匹配的请求都会进入）
• 同级别, 先定义的优先匹配

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 ]
}

结果

/                        -> config A #精确完全匹配，即使/index.html也匹配不了
/downloads/download.html -> config B #B适配所有, /优先级最低, 相当于保底策略
/images/1.gif            -> config D #规则中匹配到DEF，但D的前缀匹配优先级最高, 且匹配到了后不再往下匹配, 所以D
/images/abc/def          -> config D #规则中能匹配的非常多, 但是同上, 遇到了D就停止往下匹配了
/documents/document.html -> config C #匹配到C，往下没有任何匹配，采用C
/documents/1.jpg         -> config E #匹配到CE，遇到C后未停止往下正则匹配到E, 继续匹配后面没有了, 所以E
/documents/Abc.jpg       -> config CC #最长匹配到C，往下正则匹配到CC，继续往下到E, CC和E优先级相同, CC先定义

try_files 设置

# try_files 路径1 路径2 子目录1 子目录2 OSS地址 转发后端 =状态码;
# try_files中可以配置子目录/oss/代理/状态码等, 而且可以配置多个
# 注意 location / {} 优先级最低, 极有可能部分文件被其他匹配截胡
# 注意, 有时try_files会返回500错误, 在其后加一个 =404 可以强制查找不到设置404错误
location / {
    try_files $uri $uri/ /index.php?$query_string;
}

proxy_pass 设置

# 将所有请求代理到本地运行的 Node.js 应用 (端口 3000)
location / {
    proxy_pass http://127.0.0.1:3000;
    # 或者使用域名: proxy_pass http://app-server.example.com:3000;
    # proxy_set_header xxx
}

使用 proxy_pass 时，Nginx 作为代理服务器，处理一次完整的客户端-代理-后端通信，会消耗其自身的计算资源（CPU、内存、网络 I/O），并且这个消耗涉及“上游”和“下游”两个连接。
如果使用 proxy_pass 代理OSS资源, 如果资源很大, 会极大消耗服务器的资源(包括上行/下行带宽, 设置缓存会消耗内存和磁盘)

301/302跳转

location ~ ^/q/([A-Za-z0-9]+)$ {
    return 301 /pages/receipt/index?code=$1; # 301跳转, 浏览器会记住并缓存, 修改后再次访问可能无效
    return 302 /pages/receipt/index?code=$1; # 302跳转, 浏览器不会记住
}

其他骚操作

# index中可以设置子目录 frontend/index.html
index index.html frontend/index.html index.php;

# try_files 中设置子目录
location / {
    try_files /frontend$uri $uri $uri/ /index.php?$query_string;
}

# 配合 location / 中的子目录查找
location ~ .*\.(js|css)?$
{
    try_files /frontend$uri $uri =404;
    expires      12h;
    error_log /dev/null;
    access_log /dev/null;
}

最后更新于  2025-07-31 11:11:25  并被添加「」标签，已有 144 位童鞋阅读过。

本站使用「署名 4.0 国际」创作共享协议，可自由转载、引用，但需署名作者且注明文章出处