alias指令用于将URL路径前缀完全替换为绝对物理路径，不拼接location路径段；必须满足location和alias末尾均带斜杠、路径为真实存在的绝对路径，配合try_files $request_filename可精准校验文件存在性。
alias 指令用于将某个 URL 路径前缀直接替换为服务器上的绝对物理路径，不拼接 location 中的路径段。它适合做精准、非根目录的静态资源映射，比如图片站、上传目录、前端子资源等场景。
alias 的基本写法与路径要求
location 块中使用 alias 时，必须满足两个关键条件：
- location 路径末尾带斜杠（如 /img/），且 alias 值末尾也必须带斜杠（如 /data/pics/）
- alias 后必须是已存在的绝对路径，Nginx 不会自动创建目录，也不支持变量或表达式
例如，把 /i/2024/06/a7/photo.jpg 映射到 /data/pics/2024/06/a7/photo.jpg，应写成：
alias 和 root 的本质区别
两者行为完全不同，不能互换：
-
root：把整个请求 URI 拼接到指定路径后。例如
root /var/www;+location /static/→ 请求/static/a.css就去找/var/www/static/a.css -
alias：把 location 匹配到的前缀完全移除，再把剩余 URI 拼到 alias 路径后。例如
alias /var/www/assets/;+location /static/→ 请求/static/a.css就去找/var/www/assets/a.css
错用 root 替代 alias，常导致多出一层路径而返回 404。
配合 try_files 实现可靠访问
alias 本身只做路径替换，不检查文件是否存在。要避免 404 或返回错误内容，需搭配 try_files：
- 推荐写法：
try_files $request_filename =404;—— $request_filename 是 Nginx 已根据 alias 解析出的真实磁盘路径，可准确判断文件是否存在 - 不要写
try_files $uri =404;，因为 $uri 是原始 URL，仍按 root 规则解析，容易失效
完整示例：
location /uploads/ { alias /mnt/data/uploads/; try_files $request_filename =404; expires 1h; }常见错误与验证方法
配置后若不生效，优先排查以下几点：
- 检查 alias 路径是否为绝对路径，目录是否存在、是否为空、权限是否允许 Nginx 用户读取
- 确认 location 和 alias 末尾斜杠一致：/path/ 对应 /real/path/；/path 不对应 /real/path
- 禁用 rewrite 或 if 在 alias 块内，它们会干扰 URI，破坏 alias 的前缀替换逻辑
- 开启 debug 日志：
error_log /var/log/nginx/debug.log debug;，查看日志中 “open()” 调用的实际文件路径是否符合预期
