为什么docker-compose配置env_file后构建时Dockerfile的ARG变量为空？

两个Docker配置的作用范围完全独立，不存在自动联动：

• env_file 是容器运行时配置：仅在容器启动完成、内部业务进程开始运行时，把文件内的键值对注入到容器的环境变量中，对镜像构建阶段（执行Dockerfile指令生成镜像的全过程）完全没有影响。
• Dockerfile 中的 ARG 是镜像构建阶段的参数：只在构建镜像的流程中有效，它不会自动读取项目目录下的 .env 文件，也不会自动关联 compose 配置里的 env_file 内容，必须手动通过 compose 的构建配置块传入对应值。

当前配置里把 env_file: .env 写在服务顶层节点，仅能实现运行时的环境变量注入，完全没有给构建过程传递参数，自然导致 Dockerfile 里定义的 ARG 拿不到实际值，echo 输出为空。

要给构建阶段传参，必须在服务的 build 配置块下新增 args 节点，把 .env 里的对应值映射给 Dockerfile 定义的 ARG，配置示例如下：

version: "3.8"
services:
  app:
    build:
      context: .
      dockerfile: Dockerfile.dev
      # 新增构建参数，名称必须和Dockerfile中定义的ARG完全一致
      args:
        BUNDLE_GEMS__CONTRIBSYS__COM: ${BUNDLE_GEMS__CONTRIBSYS__COM}
    # 原有env_file配置保留，负责容器运行时的环境变量注入
    env_file: .env
    user: 1000:1000
    depends_on:
      - redis
    ports:
      - "80:80"
    volumes:
      - .:/home/ubuntu/myapp
    command: "tail -f /dev/null"

  redis:
    image: redis:latest

volumes:
  db_data:

• 此前的构建流程已经生成了带空参数的缓存镜像层，即使修改了配置，默认的增量构建还是会直接复用旧缓存，第一次验证修改效果时，需要加无缓存参数强制重建：
  docker-compose build --no-cache app
• 两类变量的使用边界不要混淆：
  • 构建阶段才需要的私有源凭据、编译参数、安装源配置：必须通过 build.args 传递
  • 容器运行时才需要的服务地址、应用功能开关、业务配置项：通过 env_file 或顶层 environment 节点配置即可
• compose 解析配置文件时，会自动读取执行命令所在目录下的 .env 文件，配置里写的 ${BUNDLE_GEMS__CONTRIBSYS__COM} 不需要额外写读取逻辑，会自动取到 .env 里的对应值传给构建参数。

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