Dockerfile构建镜像时无法找到并复制本地文件的问题排查

核心原因：Docker构建上下文不匹配 #

使用docker-compose up构建镜像时，默认构建上下文是docker-compose.yaml所在的目录，而非Dockerfile所在目录。这就导致COPY test.txt /newDir中的test.txt会从docker-compose所在目录查找，而非Dockerfile同级目录，因此出现文件找不到的错误。

具体解决方法 #

• 方法一：在docker-compose中指定构建上下文与Dockerfile路径
  在docker-compose.yaml的service-app服务配置里，明确指定构建上下文为Dockerfile所在目录，同时指定Dockerfile路径：

  services:
    service-app:
      build:
        context: ./appRoot/serviceName  # 把构建上下文设为Dockerfile所在目录
        dockerfile: Dockerfile          # 若文件名是默认的Dockerfile可省略此配置
  

  这样构建时，Docker会以./appRoot/serviceName作为上下文，COPY test.txt /newDir就能找到同级的test.txt文件。

• 方法二：调整Dockerfile中的COPY路径（不推荐，维护性差）
  若不想修改docker-compose配置，可基于docker-compose的上下文路径修改Dockerfile的COPY源路径。假设docker-compose在项目根目录，test.txt相对根目录的路径是./appRoot/serviceName/test.txt，则Dockerfile修改为：

  COPY ./appRoot/serviceName/test.txt /newDir
  

  这种方式会让Dockerfile依赖外部docker-compose的位置，后续维护易出错，优先推荐方法一。

额外验证步骤 #

• 进入docker-compose所在目录，确认./appRoot/serviceName/test.txt确实存在，避免路径拼写错误
• 单独进入./appRoot/serviceName目录，执行docker build -t test .测试Dockerfile本身是否正常，排除语法问题

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