部署Cloud Function遇Cloud Build报错：无法从缓存镜像配置文件获取OS信息

部署Cloud Function时触发的该类报错，核心原因是Cloud Build依赖的构建缓存镜像已被损坏/部分删除，和你配置的容器镜像存储生命周期清理规则直接相关。

报错本质 #

Cloud Function线上构建默认会拉取存放在GCR路径us.gcr.io/[项目ID]/gcf/[区域]/[函数标识]/cache:latest的增量缓存，用来加快构建速度。你配置的生命周期清理规则，通常设置了删除“非活跃标签镜像”“超过指定时间的构建产物”的逻辑，这类规则会误删上述缓存镜像的元数据配置，导致Cloud Build读取缓存时无法获取镜像的OS系统配置信息，直接抛出对应错误。
这种半删状态的缓存镜像，不会触发Cloud Build自动重建逻辑——只有检测到缓存镜像完全不存在时，构建流程才会自动生成新缓存，而标签存在、内容损坏的半异常状态，就会直接中断缓存初始化流程。
你本地能正常构建、模拟运行函数，是因为本地环境不会拉取线上GCR的缓存镜像，走的是独立的本地构建流程，不受线上缓存损坏的影响。

修复步骤 #

• 第一步：手动删除损坏的半残留缓存镜像，触发自动重建
  执行以下gcloud命令直接删除报错中对应的残留缓存镜像：
  gcloud container images delete us.gcr.io/MY_PROJECT/gcf/us-central1/SOME_KEY/cache:latest --quiet --force-delete-tags
  删除完成后重新执行部署命令，Cloud Build检测到缓存完全缺失，会自动生成全新的合法缓存镜像，即可正常完成线上构建。
• 第二步：调整生命周期规则，排除缓存路径避免后续误删
  修改现有的容器镜像清理规则，增加排除匹配项：不对路径包含gcf/*/cache的镜像执行删除操作。仅清理函数实际运行用的最终构建镜像（也就是路径下不带/cache后缀的函数部署镜像），既可以实现清理冗余旧镜像、降低存储成本的目标，也不会误删Cloud Build依赖的构建缓存。
• 临时应急方案：如果调整规则后仍有偶发缓存异常，可在部署命令中添加构建参数--build-env-cache=false，强制本次构建跳过缓存使用流程，直接生成全新的构建产物与缓存。

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