Docker构建报错：Dockerfile无法识别.env文件中的环境变量

报错信息 #

[+] Building 0.1s (2/2) FINISHED
 => [internal] load build definition from Dockerfile
 => => transferring dockerfile: 32B
 => [internal] load .dockerignore
 => => transferring context: 2B
failed to solve: rpc error: code = Unknown desc = failed to solve with frontend dockerfile.v0: failed to create LLB definition: base name (${BASE_IMAGE}) should not be blank

问题原因 #

你在docker-compose.yaml里配置的env_file是给容器运行阶段设置环境变量的，和Docker镜像构建阶段的ARG变量完全无关。Docker Compose不会自动把.env里的变量传递给构建过程，导致Dockerfile中FROM ${BASE_IMAGE}的变量为空，触发报错。

修复方案 #

两种可行修复方式，任选其一即可：

方案1：显式传递构建参数

修改docker-compose.yaml，在build节点下添加args字段，将.env里的BASE_IMAGE传递给Dockerfile的ARG：

version: "3.8"

services:
  my-service:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        - BASE_IMAGE=${BASE_IMAGE}  # 从.env读取变量并传递给构建阶段
    env_file:
      - .env  # 若容器运行时需要该变量则保留，否则可移除

方案2：利用Compose自动加载.env到构建参数

Docker Compose默认会自动加载当前目录下.env文件的变量，只要Dockerfile里的ARG名称和.env里的变量名完全一致，可省略显式args配置。需确保：

• .env与docker-compose.yaml在同一目录
• 无其他配置覆盖该变量

简化后的docker-compose.yaml：

version: "3.8"

services:
  my-service:
    build: .  # 上下文和Dockerfile使用默认值时可简化写法
    env_file:
      - .env

验证方法 #

修改配置后，执行以下命令重新构建：

docker-compose build

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