Hydra配置中@_here_处环境变量插值失效问题排查

问题场景 #

目录结构：

├── config/
│   ├── config.yaml
│   ├── deployment/
│   │   └── objects.yaml
│   └── environment/
│       ├── dev.yaml
│       └── prd.yaml

config.yaml内容：

defaults:
  - _self_
  - deployment: objects

尝试让objects.yaml通过环境变量动态加载environment组配置时失败：

可行配置 #

# objects.yaml
defaults:
  - _self_
  - /environment/dev@_here_

file: my-file 

不可行配置 #

# objects.yaml
defaults:
  - _self_
  - /environment/${oc.env:CLUSTER_TARGET}@_here_

file: my-file 

收到错误：

In 'deployment/objects': Could not load 'deployment/environment/dev'.

原因分析 #

错误信息显示Hydra尝试从deployment/environment/dev加载配置，而非根目录config/environment/dev，说明插值后的路径被解析为相对于当前配置文件（deployment/objects.yaml）的相对路径，而非预期的绝对路径。

解决方案 #

修改objects.yaml的defaults配置，直接引用根级environment配置组，通过环境变量指定具体的配置文件：

# objects.yaml
defaults:
  - _self_
  - environment: ${oc.env:CLUSTER_TARGET}

file: my-file 

验证步骤 #

1. 确保环境变量已正确设置：

   export CLUSTER_TARGET=dev  # 或 prd
   

2. 运行项目，Hydra会自动从config/environment/${CLUSTER_TARGET}.yaml加载对应配置。

这种写法利用Hydra的配置组引用机制，避免了路径解析歧义，同时实现了通过环境变量动态切换环境配置的需求。

内容的提问来源于stack exchange，提问作者David Clarance