在 nginx 中配置路径匹配规则,核心在于理解 `location` 指令的优先级判定逻辑。nginx 会根据请求 uri 与正则表达式或前缀字符串的匹配程度,选择最精确的规则进行处理。具体做法是:优先使用 `=` 进行精确匹配,其次使用 `^~` 进行最长前缀匹配并停止正则搜索,接着按定义顺序收集所有普通前缀匹配项(其中斜杠后缀 `/` 权重最高),最后按文件出现顺序执行正则匹配(`~` 区分大小写,`~*` 不区分)。一旦某个正则表达式匹配成功,nginx 立即终止后续搜索并应用该规则;若所有正则均不匹配,则回退到之前记录的最长前缀匹配结果。

如何确定前缀匹配的优先级
前缀匹配遵循“最长前缀优先”原则,且以 `/` 结尾的路由具有特殊的高优先级。当多个前缀规则同时匹配时,Nginx 会选择字符数最长的那个。如果长度相同,则以 `/` 结尾的规则胜出。这种机制确保了静态资源目录和 API 根路径能准确拦截请求,而不会误入更通用的通配规则。

server {
listen 80;
server_name example.com;
# 精确匹配,优先级最高
location = /favicon.ico {
log_not_found off;
access_log off;
}
# 最长前缀匹配,停止正则搜索
location ^~ /static/ {
root /var/www/html;
}
# 普通前缀匹配
location /images/ {
alias /var/www/images/;
}
location / {
proxy_pass http://backend;
}
}
上述配置中,请求 /static/js/app.js 会命中 ^~ /static/ 规则,因为它是比 / 更长的前缀,且 ^~ 标志阻止了后续正则表达式的检查。请求 /favicon.ico 将直接命中精确匹配规则。其他所有未匹配特定前缀的请求都会落入 location / 块,被代理到后端服务。
正则表达式匹配的触发条件
正则表达式匹配仅在没有任何前缀规则使用 ^~ 标志,且所有前缀匹配项都未能提供最终结果时才发生。Nginx 按照配置文件中的书写顺序依次测试正则表达式。一旦找到第一个匹配的正则表达式,就立即使用该规则处理请求,不再继续测试后续的正则规则。这种“首次匹配”机制要求开发者注意规则的排列顺序,避免通用正则拦截了特定业务逻辑。

server {
listen 80;
server_name example.com;
location ~* \.(jpg|jpeg|png|gif)$ {
root /var/www/static;
expires 30d;
}
location ~ ^/api/v[0-9]+/users$ {
proxy_pass http://user_service;
}
location / {
proxy_pass http://default_backend;
}
}
在这个示例中,请求 /images/logo.png 会匹配第一个正则表达式 ~* \.(jpg|jpeg|png|gif)$,因为扩展名匹配成功,Nginx 随即返回静态文件并停止进一步处理。请求 /api/v1/users 会匹配第二个正则表达式,被转发至用户服务。如果请求 /about,它既不符合图片格式也不符合 API 版本路径,因此会回退到最后的 location / 块。需要注意的是,如果第一个正则改为 ~ .*\.png$,它将先于第二个正则匹配 /images/logo.png,从而改变行为流程。
当正则匹配失败时如何处理回退逻辑
当所有正则表达式均未匹配当前请求 URI 时,Nginx 会回退到之前收集到的最长前缀匹配结果。这意味着即使你定义了复杂的正则规则,如果它们没有命中,系统依然会依据最接近的前缀字符串来决定路由目标。这种设计保证了无论请求多么怪异,总能找到一个默认的处理器,通常是 location / 块,从而防止 404 错误或非预期的行为中断。











