root指令将location匹配后剩余URI原样追加到指定路径后形成文件系统路径，不修改URI本身；如location /static/ { root /data; }处理/static/js/app.js时拼出/data/static/js/app.js。
在 Nginx 中，root 指令并不直接“重写”或“拼接” URI，而是定义一个文件系统路径前缀，Nginx 会将当前 location 匹配到的 URI（不含 location 前缀）追加到 root 路径之后，形成最终要查找的磁盘文件路径。理解这个“追加逻辑”是避免 404 的关键。
root 的本质：静态路径拼接，不修改 URI
root 不做任何路径解析、解码或重定向，它只是把请求 URI 的“剩余部分”原样贴到指定目录后面。
- location /static/ { root /data; }
- 请求 /static/js/app.js → 拼出 /data/static/js/app.js
- 注意：URI 中的 /static/ 完整保留在拼接路径中 —— 因为 location 是 /static/，匹配后“剩余 URI”就是 /static/js/app.js
location 前缀决定“剩余 URI”的起点
root 拼接的不是原始完整 URI，而是去掉 location 匹配前缀后的部分。这个“去掉”只发生在精确匹配或前缀匹配的 location 块内，且仅对前缀匹配生效（正则 location 不参与此拼接）。
- location /api/ { root /opt/backend; }
- 请求 /api/v1/users → 去掉 /api/，剩余 /v1/users → 拼成 /opt/backend/v1/users
- location = /index.html { root /var/www; } → 精确匹配，剩余 URI 为空 → 查找 /var/www/index.html
- location ~ \.php$ { root /srv/app; } → 正则 location 不触发 root 拼接逻辑，此时 root 实际无效（应配合 fastcgi_param SCRIPT_FILENAME 使用）
常见陷阱与避坑建议
很多 404 其实源于对“剩余 URI”理解错误，尤其是 location 配置末尾斜杠是否一致。
- 错误示范：location /assets { root /usr/share/nginx/html; } + 请求 /assets/logo.png → 剩余 URI 是 /assets/logo.png → 拼成 /usr/share/nginx/html/assets/logo.png（正确）；但若 location 写成 location /assets/（带尾部 /），同样请求 /assets/logo.png 就无法匹配该 location
- 典型误用：想让 / → 读取 /var/www/index.html，却写成 location / { root /var/www; } → 请求 / 时剩余 URI 是 /，拼成 /var/www// → 文件系统可能拒绝双斜杠或找不到
- 推荐写法：location / { root /var/www; index index.html; }，依靠 index 指令自动补全；或显式用 location = / { root /var/www; try_files /index.html =404; }
- 调试技巧：开启 error_log debug，或临时用 echo 模块（需编译）打印 $request_filename 变量，直观看到 Nginx 实际拼出的路径
root vs alias：核心区别一句话
root 把整个匹配到的 URI（含 location 前缀）追加到路径后；alias 把 location 前缀替换成指定路径。
- location /static/ { alias /data/assets/; } → /static/js/a.js → /data/assets/js/a.js
- location /static/ { root /data; } → /static/js/a.js → /data/static/js/a.js
- 所以需要“剥离 location 前缀”时，优先选 alias；只需要固定根目录+自然追加，用 root 更清晰
