alias 通过完全替换 location 路径实现虚拟路径到物理目录的精准映射，避免 root 的追加逻辑；配置时 location 和 alias 均须以 / 结尾，注意大小写、权限及避免与 rewrite 混用。
用 alias 解决 URL 路径和真实文件路径层级不匹配的问题，核心是让 Nginx 把请求的“虚拟路径”直接指向“物理目录”，跳过路径拼接逻辑。它比 root 更精准，特别适合路径结构不对等的场景。
alias 和 root 的关键区别
root 是在请求路径后“追加”location 路径；alias 是用指定目录“完全替换”location 路径。举个例子：
- 请求
/images/cat.jpg，配置root /var/www;→ 实际找/var/www/images/cat.jpg - 请求
/images/cat.jpg，配置alias /var/www/pets/photos/;→ 实际找/var/www/pets/photos/cat.jpg（/images/被整个替换了）
典型 alias 配置写法
确保 location 块中 alias 值以 / 结尾，且与 location 路径语义对齐：
- 映射
/files/到磁盘/mnt/uploadFile/：
location /files/ {
alias /mnt/uploadFile/;
autoindex off;
expires 1h;
} - 映射
/api-docs/swagger-ui/到前端构建产物子目录：
location /api-docs/swagger-ui/ {
alias /opt/app/dist/swagger-ui/;
try_files $uri $uri/ /index.html;
}
常见踩坑点与检查项
alias 容易 404，多数因路径细节没对齐：
- location 必须以
/结尾（如/files/），否则 alias 不会去掉末尾部分，导致多一层目录 - alias 值也必须以
/结尾，否则文件名会被错误拼接到路径末尾 - Linux 下注意大小写和权限：Nginx worker 进程用户（如
www-data）需对目标目录有r-x权限 - 避免在 alias 后再用
rewrite，容易引发路径混乱；优先靠 alias 本身完成映射
配合 Spring Boot 使用时的协同要点
当后端用 addResourceHandler("/files/**") 映射到 file:/mnt/uploadFile/，前端访问 /files/photo.png，Nginx 层若也走同一路径，可直接透传；但若想把所有静态资源统一收口到 /static/，就该用 alias 做路径重定向：
- Spring Boot 仍按原逻辑处理上传文件并返回
/files/xxxURL - Nginx 在反向代理前，用
location /files/ { alias /mnt/uploadFile/; }提前响应，不转发给 Spring Boot - 这样既保留了业务层 URL 设计，又把文件读取从 Java 移出，提升性能和稳定性
