使用Colima替代Docker Desktop的Docker缓存异常问题求助

一、确认构建流程的实际执行情况 #

• 执行构建时添加--progress=plain参数，强制输出完整构建日志，验证两个阶段是否都重新执行：

  docker-compose build --no-cache --progress=plain api
  

  重点检查阶段0（Go编译阶段）的COPY . .、RUN go build步骤是否重新执行，以及阶段1的COPY --from=0 ...是否复制了新生成的可执行文件。

二、检查镜像与容器的状态一致性 #

• 查看构建前后的镜像ID是否更新：

  docker images | grep <你的API镜像名称>
  

  若镜像ID未变化，说明--no-cache参数未生效，或Colima的镜像存储存在异常。
• 验证容器使用的镜像是否为最新构建版本：

  docker inspect <API容器名称> | grep -i image
  

  若容器仍使用旧镜像ID，说明docker-compose up未拉取新构建的镜像，可能是Compose自身的缓存逻辑导致。

三、排查Colima虚拟机内部的存储层 #

• 进入Colima虚拟机查看镜像分层信息：

  colima ssh
  

  根据Colima使用的容器引擎执行对应命令：

  # 若使用Docker引擎
  docker image inspect <API镜像ID>
  # 若使用containerd引擎
  ctr images inspect <API镜像名>:<标签>
  

  检查各分层的创建时间，确认最新构建的分层是否正确生成。

四、验证Docker Compose的配置与执行逻辑 #

• 检查docker-compose.yml的build配置，确认是否存在隐藏的target或cache_from字段，导致复用旧缓存。
• 尝试用--build参数直接启动，强制重新构建后启动容器：

  docker-compose up --no-deps --build api
  

  该命令会跳过依赖服务，优先重新构建API服务并启动，无需手动删除镜像容器。

五、隔离测试定位问题根源 #

• 绕过Docker Compose，直接用Docker命令构建运行：

  docker build --no-cache -t my-api .
  docker run --rm my-api
  

  若此方式下代码变更能生效，说明问题出在Docker Compose与Colima的交互逻辑，而非Colima本身的缓存。
• 重置Colima虚拟机清空所有缓存：

  colima stop
  colima delete
  colima start
  

  重新构建启动后，若问题消失，说明之前的虚拟机存储存在异常缓存。

六、Go构建阶段的特殊检查 #

• 查看Go编译步骤的日志，确认go build是否重新编译了代码（是否输出编译包的相关信息），避免因依赖缓存（如go mod download）导致的编译步骤复用。
• 验证阶段1中复制可执行文件的路径是否正确，确保从阶段0复制的是最新生成的可执行文件，无路径拼写错误。

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