root指令用于设定静态文件查找的基准目录，Nginx将请求URI（去掉开头/后）原样拼接到root指定的绝对路径末尾来定位文件；可置于http、server或location块，优先级为location>server>http。
root 指令是 Nginx 配置静态资源最基础、最常用的路径控制方式，它的作用不是指向某个具体文件，而是告诉 Nginx：“所有请求的路径，都从这个目录开始往下找”。
root 的基本写法和生效位置
root 后面必须跟一个**绝对路径**（强烈推荐），例如：
root /var/www/my-site;root /srv/app/dist;
它可以放在 http、server 或 location 块中。优先级规则是：location > server > http。也就是说，如果某个 location 块里写了 root，就以它为准；没写才会向上继承上级配置。
root 是怎么拼出真实文件路径的
Nginx 会把客户端请求的 URI（去掉开头的 / 和查询参数后剩余部分）**原样追加到 root 路径末尾**，然后去磁盘查找。
- 配置：
root /data/web; - 访问
/about/team.html→ 查找/data/web/about/team.html - 访问
/→ 查找/data/web/index.html（前提是启用了index index.html;）
注意：URI 开头的斜杠 / 不参与拼接，只取后面的部分。
多个静态目录怎么分别映射
用多个 location 块配合独立的 root 即可实现不同 URL 前缀对应不同物理目录：
-
location /images/ { root /opt/assets/images; }→ 请求/images/logo.png查找/opt/assets/images/logo.png -
location /uploads/ { root /var/uploads; }→ 请求/uploads/file.pdf查找/var/uploads/uploads/file.pdf
⚠️ 注意最后一例：因为 root 是拼接完整 URI，所以 /uploads/file.pdf 实际变成 /var/uploads/uploads/file.pdf。如果想让 /uploads/ 直接对应 /var/uploads/ 下的文件，应改用 alias。
常见误区与建议
- 不要在
root路径末尾多加斜杠（如root /var/www/;），Nginx 会自动处理，多加不影响但不规范 - 路径必须是容器内或 Nginx 进程可读的绝对路径；Docker 环境中要确保挂载路径与配置中的路径一致
- 配合
try_files $uri $uri/ =404;可增强容错，避免因路径不匹配返回空白页 - 需要精确替换路径前缀时（比如
/static/→/data/assets/），优先考虑alias而非root
