Nginx能否为同一请求匹配多个location？配置冲突求解

问题根源 #

正则location的优先级高于前缀location（location /static/是前缀匹配），所以/static下的图片会先被正则location匹配，而正则location里没有配置alias/root，导致Nginx从默认根路径加载，最终失败。

解决方案1：同时启用多个Alias Location与特定后缀规则 #

要让后缀规则既能作用于静态资源，又不破坏alias的路径映射，有两种常用方式：

方式一：嵌套子Location到每个Alias块内 #

将后缀规则作为子location放到每个alias的location块里，这样只有请求匹配当前alias路径时，才会应用后缀规则，同时继承父location的alias配置：

location /static/ {
    alias /app/static/;

    location ~* \.(png|jpg|jpeg|gif|css|js)$ {
        access_log off;
        log_not_found off;
        expires max;
    }
}

# 其他alias location同理
location /assets/ {
    alias /app/assets/;

    location ~* \.(png|jpg|jpeg|gif|css|js)$ {
        access_log off;
        log_not_found off;
        expires max;
    }
}

方式二：调整正则Location的匹配范围 #

如果不想嵌套，可修改正则location，让它只匹配非alias路径下的后缀资源，或者明确指定要匹配的路径前缀：

# 匹配所有路径下的指定后缀，但排除/static/和/assets/路径
location ~* ^/(?!static/|assets/).*\.(png|jpg|jpeg|gif|css|js)$ {
    access_log off;
    log_not_found off;
    expires max;
}

location /static/ {
    alias /app/static/;
}

location /assets/ {
    alias /app/assets/;
}

注：正则location搭配alias时要注意路径匹配逻辑，alias会替换location匹配的前缀部分，而root是直接拼接路径，所以正则场景下用root往往更不容易出错。

解决方案2：大量Alias时统一添加后缀规则 #

当有大量alias路径时，逐个嵌套会很繁琐，可通过以下两种方式统一处理：

方式一：Map指令+正则匹配 #

先定义map指令，将请求前缀映射到对应的本地路径，再用正则location统一处理：

http {
    map $uri $alias_path {
        ~^/static/ /app/static/;
        ~^/assets/ /app/assets/;
        ~^/uploads/ /app/uploads/;
        # 更多alias映射...
    }

    server {
        # 处理alias路径下的指定后缀资源
        location ~* ^/(static|assets|uploads)/.*\.(png|jpg|jpeg|gif|css|js)$ {
            alias $alias_path;
            access_log off;
            log_not_found off;
            expires max;
        }

        # 处理alias路径下的非后缀资源
        location ~* ^/(static|assets|uploads)/ {
            alias $alias_path;
        }
    }
}

这种方式把所有alias路径集中在map里管理，便于统一维护。

方式二：通用配置片段+Include引入 #

创建一个名为static_suffix_rules.conf的文件，内容为后缀规则：

location ~* \.(png|jpg|jpeg|gif|css|js)$ {
    access_log off;
    log_not_found off;
    expires max;
}

然后在每个alias location里引入这个片段：

location /static/ {
    alias /app/static/;
    include static_suffix_rules.conf;
}

location /assets/ {
    alias /app/assets/;
    include static_suffix_rules.conf;
}

# 其他alias location同理

修改规则时只需编辑单个文件，无需逐个修改alias块。

关于“匹配一个Location后继续匹配其他规则” #

Nginx的location匹配逻辑是一旦匹配到优先级最高的location，就会进入该location处理，默认不会继续匹配其他location。但有两种方式实现类似“多规则叠加”的效果：

1. 嵌套location：如解决方案1中的方式一，父location匹配后，子location可以进一步匹配请求，这是Nginx中最常用的多规则组合方式。
2. Rewrite指令配合last参数：如果需要在一个location处理后让请求进入另一个location，可使用rewrite ... last;，它会让Nginx重新发起一次请求匹配，从而进入其他location。但要注意避免循环匹配。

示例：

location /static/ {
    alias /app/static/;
    rewrite ^/static/(.*)$ /internal-static/$1 last;
}

location /internal-static/ {
    root /app;
    access_log off;
    expires max;
}

不过这种方式不如嵌套直接，非特殊场景优先使用嵌套。

内容的提问来源于stack exchange，提问作者Ivan Voras