Docker构建COPY找不到文件:检查构建上下文

适用范围:使用docker build或Compose build构建镜像;示例只用于测试副本。

报错写着文件不存在,但宿主机确实有这个文件,先看它是否处于本次构建上下文中。Dockerfile所在目录与构建上下文不一定相同。

找到命令末尾的路径

下面命令的构建上下文是当前目录的 .,不是docker目录:

docker build -f docker/Dockerfile -t app:test .

假设项目结构如下:

project/
  app/main.py
  docker/Dockerfile
  .dockerignore

从project目录执行上面的命令时,Dockerfile中的 COPY app/ /app/ 从project/app读取。把命令末尾改成 docker/ 后,上下文中就不再包含这个app目录。[1]

文件是否被忽略或根本未生成

在正确项目目录检查需要复制的文件和忽略规则:

pwd
ls -ld -- app docker .dockerignore

逐行查看 .dockerignore 中是否排除了目标目录。存在与Dockerfile对应的专用ignore文件时,也要核对它;不要只读根目录的一份文件。[1]

若COPY的是dist或编译产物,确认构建前已经生成。开发电脑上有文件,不代表代码仓库或流水线中也有;不能用缓存命中来证明新环境能正常构建。

Compose的相对路径按配置位置核对

Compose项目应查看实际使用的 build.context 与 dockerfile。多份配置合并、不同工作目录或 -f 参数都可能改变预期。可先用配置验证命令检查语法;展开配置可能包含凭据,只在受控终端查看。

不要把上下文扩大到整个磁盘来“让文件都能找到”,也不要删除忽略密钥、备份、个人配置的规则。镜像构建会让上下文内的内容进入处理范围,应只包含必要文件。[1][2]

在干净测试目录构建一次

修复路径或构建步骤后,使用新测试标签构建,不覆盖正在发布的固定标签。确认产物包含预期文件、不包含.env、私钥或客户数据,再完成应用启动和健康检查。

COPY --from=... 的来源还可能是其他构建阶段或镜像,不是宿主机;这种错误应继续追查对应阶段的输出路径。路径修对后若转为权限或架构错误,按新的错误处理。

继续排查

Ubuntu安装Docker Engine与Compose;Docker应用更新失败,怎样退回原来的版本。

技术依据:[1] Docker构建上下文与ignore文件;[2] Docker Compose build规范。适用版本见本文说明。