使用COMPOSE_ENV_FILES替代--env-file未达预期效果的问题

错误根源 #

COMPOSE_ENV_FILES 不是用来替代 --env-file 参数的——它的作用是让Docker Compose CLI自身读取配置类环境变量（比如COMPOSE_PROFILES这类控制Compose行为的变量），不会把指定文件里的变量传递给服务容器，所以你设置后服务里的变量为空是正常的。

解决方法 #

方法1：在docker-compose.yml中动态指定环境文件 #

修改你的docker-compose.yml，给目标服务添加env_file配置，用自定义环境变量指定要加载的文件路径：

services:
  # 替换成你的实际服务名
  your-service:
    env_file:
      - ${CUSTOM_ENV_FILES}
    environment:
      # 这里引用.env文件中的变量
      - DB_HOST=${DB_HOST}
      - API_KEY=${API_KEY}

启动前设置自定义环境变量：

export COMPOSE_PROFILES=profile1,profile2
export COMPOSE_FILE=file1.yml:file2.yml
export CUSTOM_ENV_FILES="env.common,env.qa"

docker compose up

方法2：合并.env文件后用默认加载 #

如果不想修改docker-compose.yml，可以把多个环境文件合并成默认的.env（Compose会自动加载该文件）：

# 合并文件，后面的文件会覆盖前面的重复变量
cat env.common env.qa > .env
export COMPOSE_PROFILES=profile1,profile2
export COMPOSE_FILE=file1.yml:file2.yml

docker compose up

方法3：批量传递--env-file参数 #

如果只是不想手动输入多个--env-file，可以用变量拼接参数：

export ENV_ARGS="--env-file env.common --env-file env.qa"
export COMPOSE_PROFILES=profile1,profile2
export COMPOSE_FILE=file1.yml:file2.yml

docker compose up $ENV_ARGS

内容的提问来源于stack exchange，提问作者felix at housecat