Docker Compose无法从自定义.env文件传递构建参数的原因排查

核心原因 #

docker-compose.yml里的env_file配置是给容器运行阶段提供环境变量的，和镜像构建阶段的build.args完全无关。构建时要解析的${MYENV}变量，Docker Compose只会从两个地方读取：

• 当前执行命令的shell环境变量
• 默认名为.env的文件（Compose会自动加载这个文件）

你的环境变量文件叫.myenvs，不是Compose默认加载的.env，所以构建时${MYENV}无法被正确替换，导致Dockerfile中的ARG为空，触发报错。而用--env-file .myenvs执行命令时，你显式告诉了Compose要加载这个文件的变量，所以${MYENV}能被正确解析。

解决方案 #

你可以任选以下一种方式解决：

1. 重命名环境变量文件为.env #

把.myenvs改名为.env，Docker Compose会自动加载这个文件里的变量，直接执行docker compose build即可正常构建。

2. 在构建命令中显式指定env文件 #

保持文件名不变，每次构建时加上--env-file参数：

docker compose -f docker-compose.yml --env-file .myenvs build

3. 在docker-compose.yml顶层配置加载自定义env文件 #

在docker-compose.yml的最顶层添加dotenv_file配置，指定要加载的环境变量文件，这样Compose在解析整个配置时会自动读取该文件的变量：

dotenv_file: .myenvs

services:
  django: &django
    build:
      context: .
      dockerfile: ./compose/Dockerfile
      args:
        MYENV: ${MYENV}
    image: env_test_image
    container_name: env_test_image
    env_file:
      - path: .myenvs
        required: true

添加后，直接执行docker compose -f docker-compose.yml build即可正常构建。

注意事项 #

• build.args是传递给Dockerfile构建阶段的参数，只在镜像构建过程中有效；env_file是容器启动时的环境变量，属于运行阶段，两者作用完全独立，不要混淆。
• 如果你的docker-compose.yml是默认文件名，执行命令时可以省略-f docker-compose.yml参数。

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