Docker-Compose传环境变量至Dockerfile RUN命令为空问题排查

问题根源分析 #

你的配置主要存在两个核心问题：

1. docker-compose.yml的build配置语法错误 #

原配置中build: my-service/的写法和后续嵌套的context、args缩进冲突，导致构建参数DATABASE_USER根本没被正确传递给Docker构建过程。Docker Compose的build字段需要是一个包含context、args等子项的对象，不能先指定路径再嵌套配置。

2. 可能的ARG作用域或使用时机问题 #

即使参数传递正确，若Dockerfile中ARG DATABASE_USER声明在RUN命令之后，或者ARG被后续构建阶段覆盖，也会导致RUN命令中变量为空。

修正后的配置示例 #

正确的docker-compose.yml #

my-service:
  build:
    context: .
    # 若Dockerfile在my-service目录下，需指定dockerfile路径；否则直接将context设为my-service/
    dockerfile: my-service/Dockerfile
    args:
      - DATABASE_USER=${DBUSR}
  container_name: my-service
  command: java -jar -Xms256M -Xmx1g -Dfile.encoding=UTF-8
  environment:
    - DATABASE_USER=${DBUSR}

正确的Dockerfile写法 #

确保ARG声明在使用它的RUN命令之前：

# 提前声明构建参数，保证后续RUN命令可访问
ARG DATABASE_USER

# 在RUN命令中直接使用该参数，替换为你的实际业务命令
RUN echo "构建阶段数据库用户：${DATABASE_USER}"
# 示例业务命令：RUN ./init-db.sh --user ${DATABASE_USER}

额外注意事项 #

• 验证宿主环境变量：执行docker-compose build前，先通过echo $DBUSR确认变量已生效；也可在项目根目录创建.env文件，写入DBUSR=你的数据库用户名，Docker Compose会自动读取该文件。
• 区分构建参数与运行时变量：environment字段的变量仅在容器运行时生效，和构建阶段的RUN命令无关，构建阶段必须通过build.args传递参数。

内容的提问来源于stack exchange，提问作者Лев Моисеевич Бетман