nginx 的 root 指令不支持环境变量（如 ${var}），因其配置文件静态解析、无变量展开机制，${var} 被当字面量处理；需通过 envsubst 模板替换、挂载预渲染配置或符号链接实现动态路径。
Nginx 的 root 指令本身不支持直接写系统环境变量（比如 ${HOME}、$PATH 或 ${APP_ROOT}），因为它不是 Shell 解释器，配置文件是静态解析的——Nginx 启动时只做一次语法检查和路径拼接，不会执行变量替换。
为什么 root 后面不能跟 ${VAR}？
根本原因有三点：
- Nginx 配置语法不内置变量展开机制，
${VAR}会被当作普通字符串字面量处理，最终拼成类似/opt/${APP_ENV}/static这样的非法路径，导致 404 或启动失败 -
env指令在 Nginx 中仅用于向子进程导出环境变量，对root、proxy_pass等指令内容无影响 - 即使容器里通过
docker run -e APP_ROOT=/data传入变量，Nginx 进程也读不到，除非你主动做模板替换
实际可用的替代方案
要让 root 路径“动态化”，必须在 Nginx 启动前完成变量注入，而不是靠它自己解析：
-
用 envsubst 做模板渲染：把配置写成
nginx.conf.template，里面写root ${STATIC_ROOT};；启动时运行envsubst /etc/nginx/nginx.conf -
挂载预生成配置：CI/CD 流程中用
sed或gomplate替换变量后，直接挂载最终的nginx.conf到容器 -
用符号链接兜底：固定写死
root /var/www/current;，再用ln -sf /opt/myapp-v2 /var/www/current指向真实目录，既安全又免变量
哪些写法是无效或危险的？
以下常见尝试都不可行，请避免：
-
root $HOME/www;—— Nginx 不识别$HOME，会报错或当成字面路径 -
root ${APP_ROOT}/public;—— 即使变量已 export，Nginx 也不会读取 - 在配置里写
env APP_ROOT;再指望root引用它 ——env和root完全无关
不复杂但容易忽略：Nginx 只负责拼路径，不负责猜意图。想让它“认得”变量，就得先把它变成真实字符串。
