alias是路径替换而非拼接，必须以/结尾且仅用于location块；root是全量拼接，末尾/可选；二者不可混用，误用将导致404或路径错误。
Nginx 的 alias 指令本身不支持路径重写，它只是将 location 匹配到的 URI 前缀**替换为指定的文件系统路径**，且不会像 root 那样拼接完整路径。要实现“路径重写 + 别名映射”的效果（比如把 /static/xxx 映射到 /var/www/assets/xxx），关键在于正确配置 alias 并注意末尾斜杠、匹配精度和 URI 截断逻辑。
alias 的核心规则：URI 前缀被完全替换
alias 的行为是“用指定路径替换 location 中的匹配部分”，不是简单拼接。因此 location 的写法必须和 alias 路径严格对应：
- ✅ 正确（推荐）：
location /static/ {<br> alias /var/www/assets/;<br>}
访问/static/js/app.js→ 实际读取/var/www/assets/js/app.js - ❌ 错误（常见坑）：
location /static {<br> alias /var/www/assets/;<br>}
访问/static/js/app.js→ Nginx 会尝试读取/var/www/assets/js/app.js（看似对），但访问/static123也会命中该 location，导致意外交叉映射 - ⚠️ 更危险的错误：
location /static/ {<br> alias /var/www/assets;<br>}
缺少末尾/，会导致路径拼接异常，例如/static/js/app.js可能变成/var/www/assetsjs/app.js（中间无斜杠）
需要重写 URI？用 rewrite + alias 组合
如果目标是把一个 URL 路径“改写”后再交给 alias 处理（比如把 /res/images/xxx.png 改成 /images/xxx.png 再映射到磁盘），需先用 rewrite 调整 URI，再用 alias 定位文件：
- 用
rewrite ... last触发内部重定向，让新 URI 进入下一轮 location 匹配 - 为重写后的路径单独配置
location+alias - 示例：把
/res/xxx重写为/assets/xxx
location ^~ /res/ {
rewrite ^/res/(.*)$ /assets/$1 last;
}
location /assets/ {
alias /var/www/static/;
}
这样 /res/css/style.css → 重写为 /assets/css/style.css → 映射到 /var/www/static/css/style.css。
alias 与 root 的关键区别（避免混淆）
理解这个区别能避开 80% 的 alias 问题：
-
root：把 location 路径“追加”到指定目录后。例如root /var/www+location /static/→ 请求/static/js/a.js查找/var/www/static/js/a.js -
alias：把 location 匹配到的**整个前缀**替换成指定路径。例如alias /var/www/assets/+location /static/→ 请求/static/js/a.js查找/var/www/assets/js/a.js - 所以
alias更适合做“路径别名映射”，而root更适合做“站点根目录设定”
调试 alias 问题的实用技巧
当文件找不到时，优先检查这几项：
- 用
nginx -t确保语法正确，再nginx -s reload - 查看 error log（通常
/var/log/nginx/error.log），搜索open() "/path/xxx" failed，它会显示 Nginx 实际尝试打开的绝对路径，直接对比是否符合预期 - 确保 alias 指向的目录存在、Nginx worker 进程有读取权限（
ls -ld /var/www/assets） - 用
curl -I http://yourdomain/static/test.txt看响应状态码，404 表示路径错，403 表示权限问题
