alias通过精准替换url前缀解决静态资源路径问题，而非root的简单拼接；需确保location与alias均以/结尾，避免路径粘连，且不可在正则location中使用。
用 alias 解决静态资源路径不对，关键在于“替换”而非“拼接”——它把 URL 中匹配的前缀整个去掉，再把剩下部分接到你指定的物理路径后。只要 location 和 alias 的斜杠对齐、路径语义一致，404 就基本能避开。
为什么 root 会让路径“多一层”
root 是原样拼接：请求 /admin/js/app.js，配置 root /var/www，Nginx 就去找 /var/www/admin/js/app.js。如果磁盘里没有 admin/ 这个子目录，直接 404。
alias 是精准替换：同样请求 /admin/js/app.js，配置 location /admin/ { alias /var/www/admin/; }，Nginx 会把 /admin/ 整个砍掉，只拼 js/app.js 到 /var/www/admin/ 后面，最终读取 /var/www/admin/js/app.js。
alias 配置必须守好的三条线
-
location 和 alias 都要以 / 结尾：比如
location /uploads/ { alias /home/app/public/uploads/; }。漏掉任一斜杠，Nginx 可能粘连成/home/app/public/uploadsjs/app.js这种错误路径 -
try_files 的 fallback 要带前缀：Vue/React history 模式下，得写
try_files $uri $uri/ /admin/index.html;，不能写成/index.html，否则路由兜底失败 -
别在正则 location 里硬套 alias：像
location ~ \.js$这类不支持 alias（旧版直接报错，新版虽兼容但不稳定），优先改用普通前缀匹配，例如location ^~ /static/
常见路径错位场景与 alias 写法
前端打包设了 publicPath: '/admin/'，但资源实际放在 /var/www/admin-dist/ 目录：
- 错：用 root →
root /var/www+location /admin/→ 找/var/www/admin/admin/js/app.js（多了一层 admin） - 对：用 alias →
location /admin/ { alias /var/www/admin-dist/; }→ 正确定位到/var/www/admin-dist/js/app.js
用户上传的图片存在项目外路径 /data/uploads/，想通过 /uploads/xxx.jpg 访问：
- 错：用 root →
root /data+location /uploads/→ 实际查/data/uploads/uploads/xxx.jpg - 对：用 alias →
location /uploads/ { alias /data/uploads/; }→ 直接读/data/uploads/xxx.jpg
多个 alias 共存怎么不打架
Nginx 按最长前缀匹配决定用哪个 block，所以可以放心并列写：
location /admin/ { alias /var/www/admin/; }location /docs/ { alias /opt/swagger-ui/; }location /assets/icons/ { alias /mnt/shared/icons/; }
请求 /admin/js/app.js 只命中第一个；/assets/icons/logo.png 精准落到第三个。互不影响，也不需要加 if 或嵌套。
