Dockerfile无法读取.env文件中的值，如何解决？

问题原因 #

Docker Compose默认不会自动将.env文件中的变量传递给Dockerfile的构建过程，你原来的Dockerfile里ENV USERNAME=$USERNAME中的$USERNAME是Docker构建环境内部的变量，并非.env里的值，所以无法解析。

解决方案 #

方法1：通过docker-compose.yml传递构建参数（推荐） #

这是最规范的方式，分两步修改：

1. 修改Dockerfile：用ARG声明需要接收的构建参数，再赋值给ENV：

FROM busybox:latest as build
# 声明构建阶段的参数
ARG USERNAME
# 将参数赋值给容器环境变量
ENV USERNAME=$USERNAME

2. 修改docker-compose.yml：在构建配置中指定要传递的参数，利用Docker Compose自动读取.env的特性：

services:
  # 替换成你的服务名称
  your-service:
    build:
      context: .
      # 传递.env中的USERNAME变量作为构建参数
      args:
        - USERNAME=${USERNAME}

之后执行docker compose build就能正常解析.env里的USERNAME值了。

方法2：构建时手动传递参数 #

如果不想修改配置文件，也可以在构建命令中直接通过--build-arg传递：

# 直接指定值
docker compose build --build-arg USERNAME=myuser

# 或者先加载.env到当前shell环境再传递
source .env
docker compose build --build-arg USERNAME=$USERNAME

方法3：批量传递.env变量（谨慎使用） #

如果需要传递多个.env变量，可以在docker-compose.yml中先加载.env文件，再批量声明参数：

services:
  your-service:
    build:
      context: .
      args:
        - USERNAME
        - OTHER_VAR # 替换成你需要的其他变量
    # 加载.env文件到Compose环境
    env_file:
      - .env

这种方式会自动将.env中对应的变量传递给构建参数，但注意不要传递敏感信息，避免泄露。

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