alias指令可精准映射URL路径到非root目录的文件，其核心是完全替换location路径后拼接URI；使用时需确保location与alias末尾斜杠一致，否则易致404。
在开发环境中，经常需要将前端构建产物或静态资源映射到特定 URL 路径下，而实际文件并不在 Nginx 配置的 root 目录中。这时用 alias 指令比 root 更灵活、更精准。
alias 和 root 的核心区别
alias 会**完全替换匹配的 location 路径**，然后拼接后面的文件路径；root 是在匹配路径后**追加** URI 到指定目录。这是理解 alias 行为的关键。
- 若配置
location /api/ { alias /data/static/; }，访问/api/logo.png将查找/data/static/logo.png - 若用
root写成location /api/ { root /data/static; }，则访问/api/logo.png实际找的是/data/static/api/logo.png - alias 后路径末尾的斜杠必须与 location 保持一致：location 以
/结尾，alias 也应以/结尾，否则可能 404
常见开发场景：把 dist 映射到 /static
前端构建输出在 /project/dist，希望所有 /static/xxx 请求都指向该目录下的文件：
location /static/ {
alias /project/dist/;
}注意：/static/ 和 /project/dist/ 都带尾部斜杠。这样 /static/js/app.js 就会准确映射到 /project/dist/js/app.js。
如果漏掉 alias 后的 /，比如写成 alias /project/dist;，Nginx 会尝试读取 /project/distjs/app.js（路径粘连），导致 404。
配合前端路由（如 Vue Router history 模式）使用
单页应用常需 fallback：当请求非资源路径（如 /user/profile）时，仍返回 index.html，由前端路由处理。可结合 alias 与 try_files：
location / {
alias /project/dist/;
try_files $uri $uri/ /index.html;
}但注意：alias 不能直接用于 location /（Nginx 1.19+ 支持，旧版本会报错）。更稳妥的做法是：
- 用
root配合重写，或 - 改用带路径的 location，例如
location /app/，再 alias 到 dist，并在前端配置 base 为/app/
调试 alias 映射是否生效
遇到 404 时，开启 Nginx 错误日志能快速定位问题：
error_log /var/log/nginx/debug.log debug;
日志中会显示 Nginx 实际尝试打开的文件路径，例如：
*1234 open() "/project/dist/js/app.js" failed (2: No such file or directory)据此可判断是路径拼接错误、权限不足，还是文件确实不存在。
