如何从Python模块而非CLI调用Hydra应用并规避插值错误？

我原本的Hydra项目结构如下：

my_package
|
├── config
│   ├── config.yaml
└── main.py

main.py代码示例：

import hydra    
from omegaconf import DictConfig

@hydra.main(version_base=None, config_path="conf", config_name="config")
def main(cfg: DictConfig):
    print('hello!')
    
if __name__ == '__main__':
    main()

直接在项目目录下执行python main.py即可正常运行。现在需要将代码产品化并部署到Docker容器中，因此重构为Python包，尝试用以下方式运行应用：

import my_package
import os
from importlib.resources import files
from omegaconf import OmegaConf

# 从setup.py清单包含的非代码文件加载配置
cfg = OmegaConf.load(os.path.join(files("my_package"), 'conf', 'config.yaml'))

# 启动Hydra应用
my_package.main(cfg)

但运行时报错UnsupportedInterpolationType: Unsupported interpolation type hydra，推测是传入的配置不符合Hydra的要求。我了解compose API可独立于@hydra.main构建配置，但已有现成配置，仅希望无需通过CLI即可运行应用，请问是否有可行方案？

方法1：用Hydra的initialize+compose加载配置（推荐） #

直接使用Hydra官方API加载配置，能自动处理配置中的hydra插值语法，无需修改原有配置文件：

import hydra
from my_package import main

def run_app():
    # 初始化Hydra，指定配置所在的包路径
    with hydra.initialize(version_base=None, config_path="my_package/conf"):
        # 加载目标配置文件
        cfg = hydra.compose(config_name="config")
        # 调用业务逻辑函数
        main(cfg)

if __name__ == "__main__":
    run_app()

方法2：修改原有main函数，兼容两种调用方式 #

如果不想改动启动逻辑，可以调整main函数的结构，让它既支持@hydra.main的CLI调用，也支持直接传入配置：

# my_package/main.py
import hydra
from omegaconf import DictConfig, OmegaConf
import os
from importlib.resources import files

# 核心业务逻辑，只负责处理配置
def main(cfg: DictConfig):
    print('hello!')

# 供CLI调用的入口
@hydra.main(version_base=None, config_path="conf", config_name="config")
def hydra_main(cfg: DictConfig):
    main(cfg)

# 供包内/外部直接调用的入口
def run_from_package():
    cfg_path = os.path.join(files("my_package"), 'conf', 'config.yaml')
    # 加载配置并启用Hydra插值解析
    cfg = OmegaConf.load(cfg_path)
    OmegaConf.resolve(cfg)
    main(cfg)

if __name__ == '__main__':
    hydra_main()

外部调用时只需执行：

from my_package import run_from_package

run_from_package()

方法3：替换配置中的hydra插值语法（不推荐） #

如果配置里的hydra插值仅为简单路径或变量，可以手动替换为OmegaConf原生支持的插值类型（如env或str），但这种方式需要修改原有配置文件，长期来看不利于维护。

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