在 nginx 中，`root` 指令的值如果包含变量（如 $uri），必须将其放在 `location` 块内部。nginx 的主配置层级不支持变量解析，因此将含变量的 `root` 写在主上下文或 `server` 块顶层会导致配置加载失败或行为不符合预期。
为什么 root 不能直接写变量
Nginx 的配置解析分为两个阶段：启动时解析和请求时处理。`root` 指令属于静态配置指令，它在 Nginx 启动并读取配置文件时就被确定。如果在 `root` 的值中使用了变量，Nginx 的解析器会报错，提示该指令不允许使用变量。这是由 Nginx 的设计决定的，旨在保证核心路径映射的性能和确定性。
server {
listen 80;
server_name example.com;
# 错误写法：Nginx 启动时会报错
# root /var/www/$host;
location / {
# 正确写法：在 location 块内使用变量
root /var/www/html;
index index.html;
}
}
如何动态指定根目录
如果需要基于请求内容动态改变根目录，可以使用 `if` 指令配合变量赋值，或者更推荐的方式是使用 `map` 指令预计算变量值，然后在 `location` 中使用。但最直接的动态 `root` 实现通常依赖于 `try_files` 结合变量，或者在 `location` 内部通过 `set` 指令设置变量后引用。不过，需要注意的是，`root` 指令本身在 `location` 中依然遵循静态优先原则，若需完全动态，往往需要借助 `alias` 或在应用层处理。对于大多数场景，在 `location` 块内定义 `root` 并使用 `$uri` 等变量作为路径的一部分是可行的，只要该变量在请求处理阶段有值。
server {
listen 80;
server_name example.com;
location /static/ {
# 假设我们想根据用户ID动态提供文件
# 注意：root 中的变量会在请求时解析
set $user_root /var/www/users/$arg_uid;
root $user_root;
# 确保文件存在
try_files $uri =404;
}
}
基于 $uri 变量的具体路径匹配问题
当 `root` 路径中包含 `$uri` 变量时，Nginx 会将当前请求的 URI 拼接到根路径下。例如，如果 `root` 设置为 `/var/www/$uri`，请求 `/index.html` 时，实际访问的路径将是 `/var/www//index.html`。这通常不是期望的行为，因为双斜杠可能导致路径解析错误或文件未找到。正确的做法是避免在 `root` 中直接使用 `$uri`，而是让 `root` 指向一个固定的基础目录，然后依靠 Nginx 内部的 `root` 拼接机制自动追加 `$uri`。即 `root /var/www/html;` 会自动映射 `/index.html` 到 `/var/www/html/index.html`。如果确实需要基于 URI 结构动态选择不同根目录，应使用 `map` 指令将 URI 模式映射到具体的目录路径，然后在 `location` 中使用该映射后的变量作为 `root` 的值。
