Docker Compose多env_file变量展开失效问题求助

问题根源 #

Docker Compose处理env_file时，不会在多个env文件之间进行变量插值。file2中的${MY_USERNAME:-}只会尝试读取主机环境中的MY_USERNAME变量，而不会引用file1里定义的值——因为env文件的内容是被直接加载为容器环境变量，加载过程中不做跨文件的变量解析。

可行解决方案 #

方案1：用Compose扩展字段复用变量（推荐） #

把公共变量定义在Compose的扩展字段中，通过YAML锚点复用，再在需要的服务中引用：

# 定义公共变量扩展字段
x-common-env: &common-env
  MY_USERNAME: "my_user"

service_1:
  image: service_1_image
  container_name: service_1
  environment:
    <<: *common-env  # 复用公共变量

service-2:
  image: service_2_image
  container_name: service_2
  environment:
    <<: *common-env  # 复用公共变量
    SAME_USERNAME: "${MY_USERNAME}"  # 引用已定义的变量

这种方式既实现了变量复用，又避免了多余变量，Compose会正确处理变量插值。

方案2：在服务中直接用environment字段引用 #

保留file1，在service-2的environment字段中直接定义SAME_USERNAME并引用file1中的变量：

service_1:
  image: service_1_image
  container_name: service_1
  env_file: 
    - file1

service-2:
  image: service_2_image
  container_name: service_2
  env_file: 
    - file1
  environment:
    SAME_USERNAME: "${MY_USERNAME}"

此时MY_USERNAME来自file1，Compose会在解析服务配置时完成变量替换，SAME_USERNAME能正确获取值。

方案3：预处理env文件（适合CI/自动化场景） #

如果必须用多个env_file，可以用envsubst工具预处理模板文件，生成最终的file2：

1. 创建file2.template：

SAME_USERNAME="${MY_USERNAME:-}"

2. 先加载file1中的变量到当前环境，再生成file2：

# 加载file1的变量到当前shell环境
set -a
source file1
set +a
# 替换模板生成file2
envsubst < file2.template > file2

3. 再运行docker-compose up

说明 #

你遇到的不是bug，是Compose的设计逻辑：env文件仅负责批量导入键值对，不支持文件间的变量引用。上述方案都能满足你“复用变量且不引入多余变量”的需求。

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