我要评论nginx的location配置，你是“迷路小菜鸟”还是“火箭工程师”？
你有没有遇到过这些“坑”：
- /api的请求被分配到/static目录？
- /favicon.ico的请求总被忽略？
- 正则匹配和前缀匹配打架？
这就是 nginx的location匹配规则 的“魔法”！它让你的请求处理像“高速公路”一样高效，像“瑞士军刀”一样灵活。
本文将带你从 “迷路小菜鸟” 到 “火箭工程师”，手把手教你写出“神级配置”！
第一战：基础操作——“快递分拣站”的规则
1.1 精确匹配（=）：快递员的“人脸识别”
问题：只有完全相同的路径才能触发配置？
解决方案：用 = 实现精确匹配！
# 精确匹配 /favicon.ico
location = /favicon.ico {
root /var/www/static; # 指定静态文件路径
expires 30d; # 浏览器缓存30天
}
# 请求示例：
# ✅ 匹配：http://example.com/favicon.ico
# ❌ 不匹配：http://example.com/favicon.ico?version=1
注释：
= /path：必须完全匹配，连查询参数（?后的内容）都不行！rootvsalias：root：路径拼接（如/favicon.ico→/var/www/static/favicon.ico）。alias：路径替换（如/static/images/logo.png→/var/www/images/logo.png）。
1.2 前缀匹配（无修饰符）：快递员的“地址模糊搜索”
问题：想匹配所有以 /api 开头的请求？
解决方案：用 普通前缀匹配！
# 匹配所有以 /api 开头的路径
location /api {
proxy_pass http://backend_api; # 反向代理到后端api
}
# 请求示例：
# ✅ 匹配：/api/user、/api/v1/login
# ❌ 不匹配：/apicheck（因为开头不是/api）
注释：
- 最长前缀优先：如果有两个前缀匹配（如
/api和/apic），nginx会选最长的。 - 结尾斜杠的玄机：
location /api/：必须以/api/开头（如/api/123）。location /api：会匹配/api和/apic！
第二战：正则匹配——“快递员的魔法滤镜”
2.1 区分大小写的正则匹配（~）：快递员的“显微镜”
问题：想区分 .jpg 和 .jpg？
解决方案：用 ~ 实现区分大小写的正则匹配！
# 匹配以 .jpg 结尾的图片（区分大小写）
location ~ \.jpg$ {
root /var/www/images;
expires 30d;
}
# 请求示例：
# ✅ 匹配：/photo.jpg
# ❌ 不匹配：/photo.jpg
注释：
- 正则语法：
\.表示匹配点号，$表示结尾。 - 正则顺序敏感：多个正则匹配时，nginx按配置顺序选择第一个匹配的！
2.2 不区分大小写的正则匹配（~*）：快递员的“全息扫描”
问题：想同时匹配 .jpg、.jpg、.png？
解决方案：用 ~* 实现不区分大小写的正则匹配！
# 匹配所有图片格式（不区分大小写）
location ~* \.(jpg|png|gif)$ {
root /var/www/images;
expires 30d;
}
# 请求示例：
# ✅ 匹配：/logo.png、/banner.gif
注释：
- 多格式匹配：用
|分隔多个后缀（如jpg|png|gif）。 - 性能注意：不区分大小写的正则匹配速度稍慢，慎用在高频路径上！
第三战：优先级规则——“快递员的vip通道”
3.1 优先级顺序：从“皇帝”到“平民”
问题：为什么我的正则匹配被前缀匹配覆盖了？
解决方案：牢记 优先级顺序！
# 精确匹配（皇帝级）
location = / {
root /var/www/html;
}
# 最长前缀匹配（王侯级）
location ^~ /static/ {
root /var/www/static;
}
# 正则匹配（士大夫级）
location ~ \.php$ {
proxy_pass http://php_backend;
}
# 普通前缀匹配（平民级）
location / {
root /var/www/html;
}
注释：
- 优先级顺序：
=精确匹配^~最长前缀匹配（停止后续匹配）~或~*正则匹配（按配置顺序）- 普通前缀匹配（最长匹配）
- 守则：
^~比正则更优先！
第四战：实战案例——“快递分拣站”的终极挑战
4.1 场景：电商系统的动静分离
需求：
- 静态资源（
.css、.js）直接返回，缓存30天。 - api请求（
/api/*）反向代理到后端服务。 - 所有其他请求返回
index.html。
解决方案：
# 静态资源：不区分大小写的正则匹配
location ~* \.(css|js|png|jpg|gif)$ {
root /var/www/static;
expires 30d;
}
# api请求：最长前缀匹配（优先于正则）
location ^~ /api/ {
proxy_pass http://backend_api;
}
# 默认请求：普通前缀匹配
location / {
root /var/www/html;
index index.html;
}
注释：
- 静态资源优先：用
~*匹配图片和样式表，避免被/api覆盖。 - api隔离：用
^~确保/api不被正则匹配干扰。
第五战：避坑指南——“快递员的防雷手册”
5.1 坑点1：斜杠的“隐形炸弹”
问题：为什么 /api 和 /api/ 会匹配不同的配置？
解决方案：统一路径结尾的斜杠！
# 坑点示例
location /api {
proxy_pass http://backend_api; # 匹配 /api 和 /apic
}
location /api/ {
proxy_pass http://backend_api_v2; # 仅匹配 /api/
}
# 建议：统一用 ^~ 避免歧义
location ^~ /api {
proxy_pass http://backend_api;
}
注释：
- 斜杠的玄学：
/api会匹配/api/123，但/api/只匹配/api/！ - 最佳实践：用
^~替代普通前缀匹配，避免斜杠陷阱！
5.2 坑点2：正则匹配的“顺序诅咒”
问题：为什么第一个正则匹配的配置总是生效？
解决方案：按优先级排序！
# 错误示例：正则顺序颠倒
location ~ \.jpg$ { ... } # 会被后面的覆盖！
location ~ \.png$ { ... } # 实际生效
# 正确示例：按重要性排序
location ~ \.png$ { ... } # 更重要的匹配放前面
location ~ \.jpg$ { ... }
注释：
- 正则顺序敏感：nginx会按配置顺序选择第一个匹配的正则！
- 调试技巧：用
curl -i http://example.com/test.png查看实际匹配的配置。
第六战：高级技巧——“快递员的黑科技”
6.1 使用 map 实现动态路由
问题：想根据路径动态选择后端服务器？
解决方案：用 map 指令！
# 定义变量 $backend，根据路径动态选择后端
map $uri $backend {
default http://default-backend;
"~^/xianyang/" http://xianyang-backend;
"~^/api/" http://api-backend;
}
server {
listen 80;
location / {
proxy_pass $backend; # 动态选择后端
}
}
注释：
map的魔法：根据$uri动态设置$backend，适合复杂路由场景。- 性能优势：
map是预处理指令，比if更高效！
6.2 使用 try_files 实现优雅降级
问题：想先检查静态文件是否存在，否则返回404？
解决方案：用 try_files！
location / {
try_files $uri $uri/ /index.html; # 先找文件，再找目录，最后返回首页
}
注释：
try_files的流程：- 检查
$uri是否存在（如/about.html）。 - 检查
$uri/是否存在（如/about/目录）。 - 最终返回
/index.html（适合spa应用）。
- 检查
常见问题：你问我答
q：为什么我的 /api 路径匹配了 /apic？
a：
- 因为普通前缀匹配是“最长匹配”，
/api会匹配/apic！ - 解决方法：用
^~ /api替代普通前缀匹配。
q：如何强制重定向到带斜杠的路径？
a：
- 在配置中添加
location /api { return 301 /api/; }。
q：正则匹配为什么比前缀匹配优先级低？
a：
- nginx的设计哲学是“先精确匹配，再正则匹配”，确保最长前缀优先。
结论：成为nginx的“location大师”
通过本文的七个步骤，你已经掌握了：
- 精确匹配：
=的“人脸识别”能力。 - 前缀匹配：普通前缀和
^~的“地址模糊搜索”。 - 正则匹配：
~和~*的“魔法滤镜”。 - 优先级规则：从“皇帝”到“平民”的匹配顺序。
- 实战案例：电商系统的动静分离配置。
- 避坑指南：斜杠陷阱和正则顺序诅咒。
- 高级技巧：
map和try_files的“黑科技”。
最后的小彩蛋：
如果你在开发一个“多租户系统”，记得用 map 根据子域名动态选择配置，用 ^~ 隔离公共资源路径！
以上就是nginx路径匹配的配置指南的详细内容，更多关于nginx路径匹配的资料请关注代码网其它相关文章！
发表评论