Nginx Location映射规则总结归纳与最佳实践_Java

nginx的location指令是配置请求路由的核心机制，其匹配规则直接影响请求的处理流程。下面基于官方文档和实战经验的总结：

一、location匹配规则与优先级

1. 匹配模式

nginx支持5种location修饰符，优先级从高到低为：

修饰符	说明	示例
`=`	精确匹配（最高优先级）	`location = /logo.png`
`^~`	最长前缀匹配（匹配后停止正则检查）	`location ^~ /static/`
`~`	正则匹配（区分大小写，按配置文件顺序匹配）	`location ~ \.php$`
`~*`	正则匹配（不区分大小写）	`location ~* .(jpg
无	普通前缀匹配（按最长匹配原则，优先级最低）	`location /blog/`

2. 优先级顺序

nginx按以下顺序匹配location块：

精确匹配（=）
仅当请求uri与location后的字符串完全匹配时生效。正则匹配（~/~*）
按配置文件中的书写顺序依次匹配，首个匹配的正则生效。最长前缀匹配（^~）
选择匹配uri前缀最长的location块。普通前缀匹配
按最长匹配原则选择，若多个location匹配，选择最先定义的。默认匹配（location /）
兜底处理未匹配其他规则的请求。

3. 匹配示例

假设配置如下：

location = /exact { ... }          # 精确匹配
location ^~ /prefix { ... }        # 最长前缀匹配
location ~ \.png$ { ... }          # 正则匹配（区分大小写）
location /general { ... }          # 普通前缀匹配
location / { ... }                 # 默认匹配

请求/exact → 匹配location = /exact。
请求/prefix/long → 匹配location ^~ /prefix（^~优先级高于普通前缀）。
请求/image.png → 匹配location ~* \.(jpg|png)$（不区分大小写的正则）。
请求/general/path → 匹配location /general。

二、proxy_pass路径处理规则

proxy_pass指令用于将请求转发到后端服务，其路径拼接逻辑与location配置紧密相关。

1. 路径拼接规则

场景	示例配置	请求uri	转发目标
`proxy_pass`带`/`结尾	`location /api/ { proxy_pass http://backend/; }`	`/api/user`	`http://backend/user`
`proxy_pass`不带`/`	`location /api { proxy_pass http://backend; }`	`/api/user`	`http://backend/api/user`
正则`location`	`location ~ ^/app/(.*) { proxy_pass http://app/$1; }`	`/app/v1/data`	`http://app/v1/data`

关键规则：

带/：proxy_pass的url以/结尾时，替换location匹配的部分。
不带/：proxy_pass的url不带/时，追加location匹配后的完整路径。

2. 路径截取与重写

通过rewrite指令可动态修改转发路径：

location ~* ^/api/v1/ {
    rewrite ^/api/v1/(.*) /$1 break;  # 截取/api/v1/后的路径
    proxy_pass http://backend;
}

请求/api/v1/user/123 → 转发到http://backend/user/123。

3. 特殊场景处理

unix socket转发：

location /unix/ {
    proxy_pass http://unix:/var/run/backend.sock:/;
}

避免301重定向：

location /app {
    proxy_pass http://backend;
}
# 请求/app（无结尾/）时，nginx可能自动重定向到/app/
# 使用精确匹配避免：
location = /app {
    proxy_pass http://backend;
}

三、配置优化与最佳实践

精确匹配优先
将location =块置于配置文件顶部，减少正则匹配开销。

正则匹配顺序
将高频请求的正则规则前置，提升匹配效率。

路径设计一致性
确保location和proxy_pass的url格式（是否带/）一致，避免路径拼接错误。

监控
使用error_log和access_log跟踪匹配过程，优化配置。

四、完整配置示例

server {
    listen 80;
    server_name example.com;
    # 精确匹配静态文件
    location = /favicon.ico {
        log_not_found off;
        access_log off;
        root /var/www/icons;
    }
    # 最长前缀匹配api请求
    location ^~ /api/ {
        proxy_pass http://api_server;
        proxy_set_header host $host;
        proxy_set_header x-real-ip $remote_addr;
    }
    # 正则匹配图片资源（不区分大小写）
    location ~* \.(jpg|png|gif)$ {
        expires 30d;
        root /var/www/images;
    }
    # 默认匹配
    location / {
        root /var/www/html;
        index index.html;
    }
}

配置说明：