nginx静态资源路径处理关键在于root与alias的拼接逻辑差异：root将完整uri追加到指定路径后，alias则用目标路径替换location匹配前缀；二者不可混用，且需结合location匹配优先级（=、^~、~、普通前缀）正确配置。
Nginx 处理静态资源请求路径，核心在于 location 块中如何使用 root 或 alias 指令。二者行为完全不同，选错会导致 404，关键不是“写对语法”，而是理解路径拼接逻辑。
root 指令：完整 URI 拼接到根目录后
root 不会去掉 location 匹配的前缀，而是把整个请求 URI（包括开头的 / 和匹配部分）原样追加到指定路径末尾。
- 配置：
location /static/ { root /var/www; } - 请求：
/static/css/app.css - 实际查找路径：
/var/www/static/css/app.css（注意/static/出现在 root 后） - 适用场景：站点主目录（
location / { root /var/www/html; }）、URI 路径天然对应磁盘结构
alias 指令：用目标路径替换 location 匹配部分
alias 把 location 中定义的匹配前缀（如 /static/）完全替换成 alias 后的路径，只保留 URI 中“剩余部分”。
- 配置：
location /static/ { alias /var/www/assets/; }（末尾 / 必须有） - 请求：
/static/css/app.css - 实际查找路径：
/var/www/assets/css/app.css（/static/被替换，不出现） - 适用场景：CDN 静态资源映射、前端构建产物分离存放、需要隐藏原始路径结构
location 匹配顺序影响最终结果
同一个请求可能命中多个 location，Nginx 按固定优先级决定用哪个块处理：
-
=精确匹配（如location = /favicon.ico） -
^~最长前缀匹配（如location ^~ /assets/，匹配后不再检查正则） -
~或~*正则匹配（按配置顺序，首个命中即止） - 普通前缀匹配（最长匹配原则，如
location /apivslocation /）
若多个 location 都含 root/alias，优先级高的 location 决定最终路径解析方式。
常见错误与验证方法
- 文件明明存在却返回 404：查看 Nginx
error.log，里面会明确写出它尝试访问的完整文件路径 - 误写
location /img { root /data; }→ 请求/img/logo.png实际找的是/data/img/logo.png，而非预期的/data/logo.png - alias 值末尾漏掉 /（如写成
alias /var/www/assets）→ 可能导致路径错位为/var/www/assetscss/app.css - root 和 alias 混用在同一 server 下未注意作用域：location 级别的指令会覆盖 server 级别定义
