Nginx 静态资源服务中 root 与 alias 配置有何区别

root是拼接路径（root路径+完整URI），alias是替换路径（用alias路径替换location匹配部分）；alias路径必须以/结尾且仅限location块，root可位于server或http块。

核心区别就一句话：root 是把整个请求路径“追加”到指定目录后查找文件，alias 是把 location 匹配到的前缀“替换”成指定目录再拼剩余路径。

root 怎么工作？

它把请求 URI（包括 location 匹配的部分）原样拼在 root 路径后面。磁盘里必须有和 URL 一模一样的子目录结构。

• 配置：location /admin/ { root /var/www/html; }
• 请求：/admin/js/app.js
• 实际查找：/var/www/html/admin/js/app.js
• root 值末尾加不加 / 都行，Nginx 会自动处理，但统一写成 /var/www/html/ 更稳妥

alias 怎么工作？

它把 location 中匹配的那段路径（比如 /admin/）整个去掉，只把剩下部分接在 alias 路径后面。磁盘里不需要存在 /admin/ 这个子目录。

• 配置：location /admin/ { alias /var/www/admin/; }
• 请求：/admin/js/app.js
• 实际查找：/var/www/admin/js/app.js
• alias 值末尾必须带 /，否则像 alias /var/www/admin 会导致 /admin/js/app.js 变成 /var/www/adminjs/app.js，直接 404

什么时候该用哪个？

选错指令，404 就很难避免；斜杠、前缀、location 写法这些细节，直接决定路径是否能落到真实文件上。

• 整站部署，比如 location / { root /var/www/dist; } → 用 root
• 把 /api/ 映射到 /opt/backend/ 下的文件 → 用 alias，否则会去找 /opt/backend/api/xxx
• location 用正则（如 ~ ^/img/.+.(png|jpg)$）→ 不能用 alias，必须用 root 或 try_files
• location 写成 location /static（不带结尾斜杠）→ alias 行为不可靠，务必写成 location /static/

怎么快速验证有没有配错？

打开 error_log，设为 notice 级别：

• 在 server 或 http 块里加：error_log /var/log/nginx/error.log notice;
• 故意访问一个不存在的文件，比如 /static/missing.css
• 看日志里 Nginx 实际尝试打开的路径是什么，一眼就能看出是拼多了还是替少了