Dockerfile中定义的ENV变量在docker-compose构建时不生效的问题

我之前也踩过这个坑，大概率是你的Docker Compose配置里的构建上下文或Dockerfile路径没设置对，导致Compose没用到你database/Dockerfile里的配置，或者是Compose里的环境变量覆盖了Dockerfile的值。下面分情况给你排查和解决方法：

1. 检查Docker Compose的Build配置 #

这是最常见的原因：如果你的docker-compose.yml放在project目录下，而Dockerfile在project/database子目录，你需要确保Compose明确指定了构建的上下文和Dockerfile路径。

错误示例 #

如果你的配置是这样，Compose会把project目录作为构建上下文，找不到database/Dockerfile（除非project目录下也有一个Dockerfile，这时候会用错文件）：

services:
  db:
    build: .  # 上下文是project目录，而非database目录

正确配置 #

你需要把构建路径指向database子目录，让Compose读取该目录下的Dockerfile：

services:
  db:
    # 方式1：直接指定目录（Compose会自动找该目录下的Dockerfile）
    build: ./database
    # 方式2：明确指定上下文和Dockerfile路径（适合Dockerfile改名的情况）
    # build:
    #   context: ./database
    #   dockerfile: Dockerfile

2. 检查Compose是否覆盖了环境变量 #

如果你的docker-compose.yml里给MYSQL_ROOT_PASSWORD或MYSQL_DATABASE设置了空值或者错误的值，会直接覆盖Dockerfile中定义的ENV变量。

错误示例 #

这种配置会把变量设为空，导致Dockerfile的值失效：

services:
  db:
    build: ./database
    environment:
      MYSQL_ROOT_PASSWORD:  # 空值覆盖
      MYSQL_DATABASE:

正确做法 #

• 如果想完全使用Dockerfile里的变量值，直接删掉environment里的这两行；
• 如果需要在Compose里自定义值，确保填写正确的内容：

services:
  db:
    build: ./database
    environment:
      MYSQL_ROOT_PASSWORD: your_custom_password
      MYSQL_DATABASE: your_custom_db

3. 验证构建过程 #

执行以下命令重新构建并查看日志，确认Compose是否读取了正确的Dockerfile：

docker-compose build db --no-cache

在构建日志里，如果能看到ENV MYSQL_ROOT_PASSWORD=xxx和ENV MYSQL_DATABASE=xxx的输出，说明Dockerfile被正确加载了；如果没有，那肯定是构建路径配置错了。

4. 额外排查点 #

• 确认database/Dockerfile里的ENV指令拼写正确，没有大小写错误（环境变量是大小写敏感的）；
• 手动构建时你在project/database目录执行docker build，上下文是该目录，所以能正确读取Dockerfile；而Compose如果上下文不对，就会忽略这个文件。

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