root是URI全量拼接，alias是location前缀替换；root要求磁盘路径与URL严格对应，alias则剥离匹配前缀后拼接剩余路径，末尾斜杠规则及location写法直接影响文件定位准确性。
设置 root 与 alias 的核心差异，在于 Nginx 如何处理请求 URI 与文件系统路径之间的拼接关系：一个是“追加”，一个是“替换”。选错指令，404 就很难避免；斜杠、前缀、location 写法这些细节，直接决定路径是否能落到真实文件上。
root 是 URI 全量拼接，依赖磁盘真实层级
root 把整个请求 URI（含 location 匹配部分）原封不动地追加到指定目录后。它要求磁盘中存在与 URL 路径严格对应的子目录结构。
- 配置：
location /admin/ { root /var/www/html; } - 请求：
/admin/js/app.js - 实际查找路径：
/var/www/html/admin/js/app.js - 注意：
root值末尾加不加/都可，Nginx 会自动补全，但建议统一写成/var/www/html/避免歧义 - 适用场景：整站部署（如
location / { root /var/www/dist; }），或静态资源目录结构与 URL 完全一致
alias 是 location 前缀彻底替换，不依赖磁盘路径层级
alias 会把 location 中匹配到的那部分 URI 完全去掉，只把剩余路径拼到 alias 指定目录后。它不关心磁盘里有没有 /admin/ 这个子目录。
- 配置：
location /admin/ { alias /var/www/admin/; } - 请求：
/admin/js/app.js - 实际查找路径：
/var/www/admin/js/app.js（/admin/被替换成/var/www/admin/） - 关键规则：
alias值末尾必须带/，否则会错误拼接为/var/www/adminjs/app.js - 适用场景：子应用挂载（如 Vue Router history 模式下
/admin/映射到独立 dist 目录）、Swagger UI 挂载、公共资源统一归集（/assets/icons/ → /mnt/shared/icons/）
location 斜杠和 try_files 的配合要点
无论用哪个指令，location 的写法和后续回退逻辑都影响最终行为。
-
location /admin/和location /admin行为不同：后者可能匹配/admin123，且路径拼接易出错，推荐统一使用带尾部/的写法 - 用
alias时，try_files $uri $uri/ /admin/index.html;中的/admin/index.html必须带 location 前缀，否则 Vue Router 回退会失败 - 同一
location块内不能同时出现root和alias，Nginx 启动会报错 - 正则
location（如~ \.js$）中慎用alias，虽新版支持命名捕获，但稳定性不如普通 location，生产环境优先用root或try_files
快速判断该用哪一个
看 URI 是否该出现在最终文件路径里：
- 如果访问
/static/css/a.css，你希望它对应磁盘上的/var/www/static/css/a.css→ 用root - 如果访问
/api/docs/，你只想让它指向/opt/swagger-ui/下的文件，不希望路径里有/api/docs/层级 → 用alias - 不确定时，打开 error log 并启用
rewrite_log on;（需调试编译），观察 Nginx 实际尝试访问的文件路径，比猜更可靠
