Nginx 中 alias 的核心是精准替换 location 路径前缀而非拼接，如 location /admin/static/ { alias /var/www/admin-dist/static/; } 将 /admin/static/ 替换为实际路径；必须确保 location 与 alias 末尾斜杠一致，配合 try_files 和权限检查可避免 404。
在 Nginx 中用 alias 映射前端打包资源，关键不是“放对路径”，而是让请求 URL 的前缀被精准替换为真实文件系统路径，尤其要避开 root 拼接逻辑导致的 404。以下是最常用也最稳妥的配置方式。
明确 alias 的替换规则
alias 不是拼接，是直接替换匹配到的 location 路径段。例如：
- 请求
/admin/static/js/app.js - 配置
location /admin/static/ { alias /var/www/admin-dist/static/; } - Nginx 会把
/admin/static/这一段完全替换成/var/www/admin-dist/static/，最终查找路径是：/var/www/admin-dist/static/js/app.js
⚠️ 注意：如果 location 以 / 结尾，alias 值末尾也必须带 /，否则会因路径截断失败返回 404。
部署 Vue/React 等 SPA 到子路径时的写法
比如前端构建时设了 publicPath: "/dashboard/"，所有资源请求都带 /dashboard/ 前缀：
立即学习“前端免费学习笔记（深入）”；
- 静态资源实际放在
/var/www/my-app/（含index.html、js/、css/等） - 配置如下：
location /dashboard/ {<br> alias /var/www/my-app/;<br> index index.html;<br> try_files $uri $uri/ /dashboard/index.html;<br>}
说明：
– alias 后加了 /，和 location 保持一致；
– try_files 中回退路径也要带 /dashboard/，确保前端路由能正确加载 index.html。
多级目录或动态分组映射（如 /static/css/ → /assets/css/）
用正则 + alias 可实现灵活映射：
- 请求
/static/css/main.css→ 实际读取/data/assets/css/main.css - 配置：
location ~ ^/static/(css|js|img)/(.*)$ {<br> alias /data/assets/$1/$2;<br> expires 1y;<br> add_header Cache-Control "public, immutable";<br>}
这样既避免硬编码多个 location，又保证路径精准落位，还顺手加了强缓存头。
常见踩坑点与检查清单
- alias 和 root 不要在同一个 location 中混用
- alias 值末尾斜杠必须和 location 匹配（
/static/→/path/to/static/，不能写成/path/to/static） - alias 路径需有读取权限，Nginx 工作用户（如 www-data 或 nginx）要能访问目标目录
- 配置后务必执行
nginx -t测试，再nginx -s reload - 浏览器访问资源时，打开开发者工具 Network 面板，确认状态码是 200 且响应内容正确，而非空白页或下载行为
