向Docker镜像指定目录添加下载文件失败的问题排查与解决

问题场景 #

• 需求：向Docker镜像内应用目录下的bin文件夹添加从指定服务器下载的自定义文件
• 操作：构建镜像时通过--add-host参数指定主机映射，Dockerfile中配置ENV定义下载相关变量，随后执行curl下载命令
• 异常现象：构建过程中能看到curl的下载动作日志，但启动容器后，指定的bin目录下始终找不到目标文件

排查与解决 #

排查初期曾怀疑是--add-host配置失效、curl命令的路径参数错误，直到检查Dockerfile中的ENV定义，发现变量名与值之间的等号两侧存在多余空格，错误写法示例：

ENV DOWNLOAD_URL = http://custom-internal-server/my-custom-file

Docker的ENV指令不允许等号两侧有空格，正确的写法应该是：

ENV DOWNLOAD_URL=http://custom-internal-server/my-custom-file

移除等号两侧的空格后重新构建镜像，容器内的bin目录下就能正常找到下载的自定义文件了。

原因分析 #

当ENV指令的等号两侧带有空格时，Docker会将空格解析为变量名或值的一部分，导致curl命令使用的变量值不符合预期——可能是无效的URL，或者下载了空内容。虽然构建日志会显示curl命令被执行，但实际下载操作并未成功获取目标文件，因此容器内指定目录中无文件。

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