alias会完全替换location路径而非拼接，其后必须为绝对路径且尾部斜杠需与location严格匹配：location以/结尾则alias也须以/结尾，否则会导致路径错误或404。
在 Nginx 中用 alias 映射本地绝对路径，关键在于理解 alias 与 root 的行为差异：它会**完全替换匹配的 location 路径部分**，而不是拼接。所以写法必须确保最终拼接出的文件系统路径准确无误。
alias 的基本写法规则
alias 后面跟的是**目标目录的绝对路径**，且该路径末尾是否带斜杠会影响行为：
- 如果
location以/结尾（如location /static/ { ... }），alias值也建议以/结尾，Nginx 会把请求 URI 中的/static/完全替换成该路径； - 如果
location不以/结尾（如location /file），alias值**不能**以/结尾，否则会导致路径多出一级空目录或 404； - 绝对路径必须存在、Nginx 工作进程有读取权限（通常为
www-data或nginx用户）。
常见正确写法示例
假设想把 https://example.com/assets/xxx.png 映射到服务器上的 /data/web/assets/xxx.png：
location /assets/ {
alias /data/web/assets/;
}
注意：/assets/ 和 /data/web/assets/ 都带尾部斜杠，Nginx 会把请求中的 /assets/ 替换为 /data/web/assets/，再拼上剩余 URI（如 xxx.png），得到完整路径 /data/web/assets/xxx.png。
若想把 /download/file.zip 映射到 /var/tmp/file.zip（单个文件）：
location = /download/file.zip {
alias /var/tmp/file.zip;
}
这里用了精确匹配 =，alias 指向具体文件（不加斜杠），Nginx 直接返回该文件。
容易出错的情况
错误写法（导致 404 或路径错乱）：
-
location /assets/ { alias /data/web/assets; }—— 缺少尾部斜杠，Nginx 会尝试访问/data/web/assetsxxx.png（中间无分隔符）； -
location /assets { alias /data/web/assets/; }—— location 不带尾斜杠但 alias 带了，Nginx 会把/assets替换为/data/web/assets/，然后拼上剩余路径（如/logo.png），变成/data/web/assets//logo.png（双斜杠可能被忽略，但语义混乱）； - 权限问题：即使路径写对，若
/data/web/assets/所有者不是 Nginx 运行用户，或缺少执行权限（目录需 +x 才能进入），仍会返回 403。
调试小技巧
启用 Nginx 错误日志（error_log /var/log/nginx/error.log debug;），触发请求后查看日志中实际查找的文件路径，能快速定位是路径拼接问题还是权限问题。也可以临时用 curl -I 看响应状态码辅助判断。
