复制失败：在构建上下文中找不到文件或被 .dockerignore 排除

介绍

在使用 Docker 进行容器化部署时，我们通常需要在 Dockerfile 中定义镜像构建过程中所需的文件和依赖，然而在构建过程中可能会遇到 复制失败：在构建上下文中找不到文件或被 .dockerignore 排除：stat package.json：文件不存在 之类的错误。那么这个错误是什么意思，该如何避免和解决呢？本文将对这些问题进行一一介绍。

错误信息

通常在构建 Docker 镜像时，我们会使用 COPY 或 ADD 指令从本地复制文件到镜像中。然而，如果使用这些指令时出错，可能会看到以下错误信息：

Step 3/8 : COPY package*.json ./
COPY failed: stat /var/lib/docker/tmp/docker-builder183383622/package.json: no such file or directory

这个错误信息告诉我们，指定的源文件不存在，因此 Docker 无法复制它。这个问题通常发生在以下情况下：

• 指定的源文件路径错误
• 源文件不存在
• 源文件被 .dockerignore 文件排除了

解决方法

避免和解决这个问题的方法如下：

指定正确的源文件路径

确保在指定源文件时，路径是正确的。在上面的错误信息中，路径为 /var/lib/docker/tmp/docker-builder183383622/package.json，这个路径可能是 Docker 自动分配的临时路径，因此出错了。如果要指定正确的路径，假设源文件在当前目录下的 ./package.json，则应该这样写：

COPY package*.json ./

确保源文件存在

确保要复制的文件在构建上下文路径中是存在的。构建上下文包含了 Dockerfile 中使用的所有文件和目录，因此源文件必须在这个路径下。

排除文件的影响

如果源文件已经存在于构建上下文路径中，但 Docker 仍然无法找到它，那么可能是 .dockerignore 文件对它进行了排除。在构建镜像时，Docker 会自动忽略 .dockerignore 文件中指定的文件和目录，以免复制不必要的文件到镜像中。如果源文件在 .dockerignore 文件中被排除，可以编辑文件或移动它以避免冲突。如果文件确实不应该被复制到镜像中，将其从 Dockerfile 中删除。

结论

在构建 Docker 镜像时，避免 复制失败：在构建上下文中找不到文件或被 .dockerignore 排除 问题的最佳方法是确保指定正确的源文件路径，确保源文件存在，以及避免 .dockerignore 的影响。