Nginx 配置静态文件：root 与 alias 的区别
root 把 URI 拼在目录后（location /images/ + root /var/www → /var/www/images/...）；alias 用指定路径替换 location 部分。路径映射用 alias，站点根目录用 root。本文用实例讲清拼接逻辑。
一句话回答：区别在于 URI 的拼接方式——root 是把请求的完整 URI 追加到指定目录后面**（location /images/ + root /var/www/html → 文件在 /var/www/html/images/）；alias 是用指定路径替换掉** location 匹配的那部分**（location /images/ + alias /var/www/images/ → 文件直接在 /var/www/images/）。站点主目录用 root，"URL 前缀映射到另一个目录"用 alias。**
root：URI 追加
server {
listen 80;
server_name example.com;
root /var/www/html;
location /images/ {
# 请求 /images/logo.png → /var/www/html/images/logo.png
}
}
拼接规则：最终路径 = root值 + 完整URI。
alias：URI 替换
location /images/ {
alias /data/pics/;
# 请求 /images/logo.png → /data/pics/logo.png
# （/images/ 这段被 alias 值替换）
}
拼接规则：最终路径 = alias值 + URI去掉location前缀的部分。
alias 的三个坑：
- 结尾斜杠必须对齐：
location /images/配alias /data/pics/——目录映射优先两端都带/；省略 location 末尾斜杠可能让额外前缀命中甚至引出越界路径风险，不是“都不带也一样安全” - alias 只用在 location 内，不能放 server 层
- 正则 location 的 alias 应引用捕获组；try_files 按当前 root/alias 检查路径，并可能触发内部跳转，需按实际配置验证
选型对照
| 场景 | 指令 |
|---|---|
| 站点主目录 | root /var/www/html;（server 层） |
| URL 前缀映射到磁盘别处 | alias |
| 同一 URI 结构对应磁盘同结构 | root |
| 前端 SPA 的 assets 目录 | 两者都行，结构一致就用 root 更省心 |
一个实用的判断法
问自己：URI 里的路径段在磁盘上是否也存在？
- 存在（
/images/对应/var/www/html/images/）→ root - 不存在（
/images/其实指/data/pics/）→ alias
映射修正后，分别请求存在与不存在的资源路径，核对响应内容及状态码。观测云 HTTP 拨测可为关键 CSS、JS 或图片 URL 分别建任务；单次首页请求不会自动验证页面引用的所有资源，404 原因仍需回到实际路径与 Nginx 配置核对。
常见问题（FAQ）
Q：alias 配完访问 404，路径怎么看？
A：错误日志里有完整的路径拼接结果：open() "/data/picslogo.png" failed——照着日志里的实际路径检查斜杠对齐问题。
Q：root 能不能放在 location 里？
A：能，且常见（某些 location 单独指定 root）。只是要注意它会覆盖 server 层的 root，URI 拼接按本 location 的 root 值来。
Q：alias 后面跟变量可以吗？
A：可用变量，但不得使用 $document_root/$realpath_root。不要直接把任意请求 Host 拼成磁盘目录，优先固定路径或严格映射允许的主机名；正则 location 使用明确的捕获组。
参考资料
本文依据官方资料核对，未进行现场运行测试；代码与配置示例需结合实际版本、权限和环境验证。
- nginx.org：ngx http core module
- docs.guance.com：http
- docs.guance.com：logging
- docs.guance.com：browser test
