如何通过--build-arg覆盖Dockerfile中继承的环境变量

问题现象 #

构建基础镜像和自定义镜像时，自定义镜像基于基础镜像，但通过--build-arg传递的环境变量未覆盖基础镜像中的值，最终镜像保留的是基础镜像的MY_ENV值。

原因分析 #

在自定义Dockerfile中执行ENV MY_ENV=${MY_ENV}时，如果ARG MY_ENV未被正确赋值（比如构建参数传递异常，或ARG未明确默认值），Docker会 fallback 到基础镜像已存在的MY_ENV环境变量值，导致无法覆盖。

解决方案 #

方法一：为ARG设置默认值，确保构建参数被正确捕获 #

修改自定义镜像的Dockerfile，给ARG MY_ENV指定默认值（空字符串即可），保证构建时传递的参数能被正确读取并覆盖基础镜像变量：

# custom.Dockerfile
FROM my_base_image
# 定义ARG并设置默认值，避免未传递参数时继承基础镜像值
ARG MY_ENV=""
ENV MY_ENV=${MY_ENV}
ENV IMAGE='This container is from a custom image'
# RUNs to setup custom images
# ...

重新构建自定义镜像：

docker build --file 'custom.Dockerfile' \
  --build-arg MY_ENV='my_value_in_custom' \
  --tag 'my_custom_image' .

方法二：直接引用构建参数（简化写法，需确保必传参数） #

如果能保证构建自定义镜像时一定会传递--build-arg MY_ENV，可以省略自定义Dockerfile中的ARG定义，直接在ENV中引用构建参数：

# custom.Dockerfile
FROM my_base_image
ENV MY_ENV=${MY_ENV}
ENV IMAGE='This container is from a custom image'
# ...

这种写法更简洁，但如果构建时未传递参数，会直接继承基础镜像的MY_ENV值，可靠性不如方法一。

验证结果 #

构建完成后运行容器，查看环境变量确认覆盖效果：

docker run my_custom_image env

此时MY_ENV的值应为my_value_in_custom，成功覆盖基础镜像中的原始值。

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