Golang升级公司内部依赖CI环境出现checksum mismatch错误如何解决

校验和不匹配的核心是本地与CI节点拉取到的对应版本私有模块源码内容不一致，导致两边计算出的h1哈希存在差异。你回退版本仍然报错，大概率是go.sum残留了冲突哈希记录，或是代理层缓存了错误的模块内容。

• 核对本地与CI节点的Go环境变量配置，重点检查GOPROXY、GOPRIVATE、GONOSUMDB三个参数是否一致
• 检查organization.team/repo对应commit 123ab4567890是否被强制推送重写过，同一commit哈希对应源码内容发生变更会直接导致不同节点拉取结果哈希不一致
• 检查本地和CI拉取私有仓库的协议、权限是否存在差异：比如本地用SSH拉取、CI用HTTPS拉取，或是CI环境配置了特殊的Git内容替换、过滤规则
• 检查CI节点的Git换行符配置，如果开启了autocrlf自动转换，会修改源码文件的换行符导致内容哈希变化
• 检查公司内部Go代理（如果有）的缓存，是否缓存了该版本模块的错误内容

1. 统一本地和CI的私有库相关环境配置，避免私有库走公共代理和公共校验数据库：

go env -w GOPRIVATE=organization.team/*
go env -w GONOSUMDB=organization.team/*
# 如果有内部Go代理，统一配置走内部代理
go env -w GOPROXY=https://internal-go-proxy.example.com,direct

2. 完全清理旧的校验和记录与缓存，重新生成go.sum：

# 删除当前项目的go.sum文件
rm go.sum
# 清理全局模块缓存
go clean -modcache
# 重新拉取依赖生成新的校验和
go mod tidy

3. 如果确认目标commit被强制重写过，直接基于最新代码生成新的伪版本号使用，同时清理所有代理层对旧版本的缓存
4. 关闭CI节点的Git自动换行符转换：

git config --global core.autocrlf false

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