Docker Compose env_file引用.env环境变量未正确替换问题求助

问题原因 #

Docker Compose 1.28+ 版本调整了变量替换的作用范围：默认仅会对 docker-compose.yml 内部的 ${} 占位符使用 .env 内的变量进行替换，不会自动将 .env 的变量注入到 env_file 指定的配置文件的解析流程中，因此 test.properties 里的 ${DB_HOST} 找不到对应值，会被替换为空。

解决方案（无需手动设置环境变量） #

方案1：调整变量定义位置（推荐，兼容性最好） #

直接将需要组合变量的定义挪到 docker-compose.yml 的 environment 字段，直接复用 .env 的变量值，修改后的配置如下：
docker-compose.yml：

version: '3.9'
services:
  busybox:
    image: busybox:latest
    environment:
      - DB_HOST=${DB_HOST}
      - DB_URL=jdbc://mysql://${DB_HOST}:app_db
    # 若test.properties还有其他无需变量替换的配置可以保留env_file，否则可以删掉
    env_file:
      - test.properties

删除 test.properties 里的 DB_URL 定义即可，此时运行 docker-compose config 就能得到预期的DB_URL值。

方案2：保留现有文件结构，通过命令自动加载.env变量 #

如果不想修改现有配置文件结构，可以在执行docker-compose命令前让shell自动加载.env的所有变量，不需要手动逐个设置：

# Linux/Mac 环境执行
export $(grep -v '^#' .env | xargs) && docker-compose up

也可以把上面的命令写进启动脚本（比如start.sh），后续直接运行脚本即可。

方案3：升级Docker Compose版本 #

该变量解析逻辑的差异是旧版V1 Compose的已知问题，升级到V2版Docker Compose（2.10+版本）后，默认支持.env变量对env_file内占位符的替换，无需修改任何配置即可得到预期结果。

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