Nginx路径匹配是请求处理第一道闸门，按=、^~、~与~*（先写先匹配）、无修饰符前缀的固定优先级顺序执行，一旦命中即停止；=为精确匹配，^~为前缀匹配且终止后续检查，正则按书写顺序尝试，普通前缀取最长匹配。
路径匹配不是“写对就能用”，而是 Nginx 请求处理链的第一道逻辑闸门。它决定请求走向文件系统、转发后端，还是被重写或拒绝。真正踩过坑的人知道：一个斜杠、一个修饰符、甚至配置顺序的微小偏差，都可能让静态资源 404、API 被错误拦截、SPA 的路由 fallback 失效。
匹配不是线性扫描，而是分阶段决策
Nginx 不是按配置顺序逐行比对，而是严格分四阶段筛选：
-
精确匹配（=）：仅当 URI 完全一致才命中，比如
location = /health只响应GET /health，不响应/health/或/health?check=1 -
最长前缀匹配（无修饰符或 ^~）：Nginx 先找出所有能匹配 URI 开头的 location，取路径最长的那个；若该 location 带
^~，则直接终止后续正则检查 -
正则匹配（~ 或 ~*）：仅在未被
^~截断的前提下，按配置出现顺序逐条尝试，第一条成功即停 - 通用兜底（/）：前面全不匹配时才生效，常用于反向代理主入口
root 和 alias 的本质区别：追加 vs 替换
二者都用于静态资源映射，但行为逻辑截然不同：
-
root 是“拼接”：请求
/static/css/app.css配location /static/ { root /var/www; }→ 实际读取/var/www/static/css/app.css -
alias 是“替换”：同样请求配
location /static/ { alias /opt/assets/; }→ 实际读取/opt/assets/css/app.css（/static/被完全替换成/opt/assets/） - 常见陷阱：用
root配 API 静态 mock 目录易多出一层路径；用alias时末尾斜杠必须与 location 保持一致，否则 403
SPA 路由 fallback 的关键细节
Vue/React 等单页应用依赖前端路由，Nginx 需把非资源请求全部导向 index.html，但极易配置失效：
- 必须用
^~限定静态资源路径，避免被后续正则规则干扰，例如：location ^~ /assets/ { root /app/dist; } - fallback 规则要放在静态规则之后、通用代理之前，典型结构：
location ^~ /static/ { ... }location ^~ /api/ { proxy_pass http://backend; }location / { try_files $uri $uri/ /index.html; } -
try_files中$uri/很重要——它让/about自动尝试/about/（触发目录索引），再 fallback 到/index.html
生产环境最常被忽略的三个动作
本地开发正常、上线就挂，往往源于这些细节：
-
URI 标准化影响匹配：Nginx 会先解码 URL（
%20→ 空格）、压缩冗余斜杠（//a///b→/a/b），所以location /test/实际匹配的是标准化后的路径，而非原始请求 -
区分大小写的隐性开关：Linux 文件系统默认区分大小写，而 Windows 不敏感；
location ~ \.png$在 Linux 上不会匹配.PNG，应改用~* \.(png|jpg|gif)$ -
location 尾部斜杠语义不可省略：
location /admin匹配/admin和/admin/及/admin/login；location /admin/才严格限定为目录层级，这对权限隔离和代理路径安全很关键
