Dockerfile中合并COPY为RUN cp命令时报错的问题排查

哥们，我来帮你分析下为啥这个RUN cp命令会报错，其实问题出在两个关键地方，咱们一步步拆解：

核心原因1：镜像里根本没有./dependencies这个路径 #

你原来的COPY指令是直接从本地构建上下文（也就是你执行docker build命令时所在的目录）把文件复制到镜像里的，不需要镜像预先存在这些文件。但RUN cp是在镜像内部的容器环境中执行的命令——如果之前没有把dependencies目录复制到镜像里，容器里自然找不到./dependencies/file1这些路径，肯定会报“找不到文件或目录”的错误。

核心原因2：复制目录时缺少递归参数 #

你要复制的folder1是个目录，而cp命令默认只能复制单个文件，复制目录必须加上-r（递归）参数，不然也会报错说“不是文件”。

两种解决办法 #

办法1：先复制依赖目录到镜像，再执行RUN cp #

如果你坚持要用RUN来合并操作，可以先把整个dependencies目录复制到镜像的临时位置，再执行cp命令，最后删掉临时目录来清理冗余：

# 先把本地dependencies目录复制到镜像的临时路径
COPY ./dependencies /tmp/dependencies

# 执行复制操作，注意目录要加-r，最后清理临时文件
RUN cp /tmp/dependencies/file1 /root/.m2 && \
    cp /tmp/dependencies/file2 /root/.sbt/ && \
    cp -r /tmp/dependencies/folder1 /root/.ivy2/cache && \
    rm -rf /tmp/dependencies

这样整个操作只占2层镜像（COPY层+RUN层），达到了你减少层数的目的。

办法2：用Docker原生的多源COPY（更推荐） #

其实Docker的COPY指令本身已经很高效，而且支持构建缓存——如果本地dependencies里的文件没变化，这几层会直接复用缓存。虽然你没法把这三个COPY合并成一个（因为目标路径不同），但其实这几层的开销非常小，而且维护起来更清晰：

COPY ./dependencies/file1 /root/.m2/
COPY ./dependencies/file2 /root/.sbt/
COPY ./dependencies/folder1 /root/.ivy2/cache/

这种写法比RUN cp更可靠，因为Docker会在构建前就校验本地文件是否存在，不会等到RUN阶段才报错，而且权限处理更符合Docker的最佳实践。

备注：内容来源于stack exchange，提问作者Ishaan Kanwar