求助：在Google Cloud部署Go应用遭遇'missing go.sum entry'错误

核心问题分析 #

部署失败的根源有两个：

1. Runtime版本不兼容：本地使用Go 1.19.2，但app.yaml指定的go116 runtime版本过旧，二者依赖校验逻辑存在差异，导致云端构建无法识别本地生成的go.sum条目。
2. RC版本依赖不稳定：使用的github.com/go-redis/redis/v9@v9.0.0-rc.1是候选版本，其间接依赖的处理逻辑在不同Go版本中存在不一致。

分步解决方案 #

1. 修正App Engine Runtime版本 #

App Engine标准环境对Go runtime标识有严格要求，不能直接写go或go119（平台暂不支持）。修改app.yaml为当前支持的最高兼容版本，例如：

runtime: go118

（可通过gcloud app runtimes list --runtime=go命令查看平台当前支持的所有Go版本）

2. 强制同步本地依赖 #

在本地项目根目录执行以下命令，彻底清理并同步依赖，确保go.sum条目完全正确：

go clean -modcache
go mod tidy
go mod verify

• go clean -modcache：清空本地模块缓存，避免旧依赖干扰
• go mod tidy：自动添加/移除依赖，生成完整的go.sum
• go mod verify：校验所有依赖的哈希值，确保与go.sum一致

3. 启用Vendor目录（可选但有效） #

如果云端构建仍存在依赖校验问题，可强制使用本地vendor目录的依赖：

1. 生成vendor目录：

   go mod vendor
   

2. 修改app.yaml，添加环境变量强制使用vendor：

   runtime: go118
   env_variables:
     GOFLAGS: "-mod=vendor"
   

4. 升级Redis依赖到稳定版 #

RC版本的redis依赖可能引入不必要的测试依赖（如ginkgo），建议升级到稳定版：

go get github.com/go-redis/redis/v9@latest
go mod tidy

验证与部署 #

1. 本地先执行go build，确保项目能正常编译
2. 重新部署：

   gcloud app deploy
   

内容的提问来源于stack exchange，提问作者Federico Perez Diduch