go模块拉取失败主因是协议切换后git url未同步更新，需配置goprivate和git config重写规则，并清理modcache彻底重建缓存，ci环境还需透传ssh鉴权。
git remote URL 从 HTTPS 切到 SSH 后，go mod download 报 401 或 403
模块拉取失败不是缓存问题，而是 Go 在解析 go.mod 中的 replace 或间接依赖时，仍按原 URL 协议发起 Git 请求。比如 github.com/org/repo 原来走 HTTPS，现在公司强制切 SSH，但 go.sum 和缓存目录里记录的仍是 HTTPS 路径，go mod download 就会尝试用 HTTPS 拉取——而新 Git 服务已禁用 HTTPS 访问，直接返回 401。
解决办法不是删缓存，而是让 Go 知道“这个域名该用 SSH”：
- 设置
GOPRIVATE=github.com/org（或通配符GOPRIVATE=*.org），否则 Go 默认仍会把私有域名送进GOPROXY流程 - 配置 Git 的 URL 重写规则：
git config --global url."git@github.com:".insteadOf "https://github.com/" - 验证是否生效：运行
git ls-remote git@github.com:org/repo HEAD，能拿到 commit hash 就说明 SSH 可用；再跑go mod download -x github.com/org/repo@v1.2.0，看最后 curl 是否消失、改成了 git+ssh 调用
本地缓存里混着 HTTPS 和 SSH 两种来源的同一模块
你可能在不同时间、不同 Git 配置下执行过 go mod download，导致 $GOPATH/pkg/mod/cache/download/github.com/org/repo/@v/v1.2.0.info 文件里记录的 Origin 字段不一致：有的指向 https://github.com/org/repo，有的是 git@github.com:org/repo。Go 不校验这个字段，但当它尝试复用缓存时，会按 .info 里记录的 Origin 协议重新 fetch —— 若协议已失效，就卡住或报错。
这时 go clean -modcache 是唯一干净解法：
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 它清掉整个
$GOPATH/pkg/mod和cache/download目录，不留残片 -
go mod download重建时，完全依赖当前 Git 配置和GOPRIVATE设置，不会再混入旧协议 - 注意：不要只删
cache/download，否则pkg/mod下残留的源码目录没校验文件，go mod verify会失败
CI/CD 流水线里 Git 鉴权未透传，导致构建时拉不到私有模块
本地 OK，流水线失败，大概率是 CI 环境没继承你的 ~/.gitconfig 或 SSH agent。Docker 容器或 runner 默认不加载用户级 Git 配置，go mod download 就只能走 HTTPS，触发鉴权失败。
必须显式注入：
- 在 CI 脚本开头加
git config --global url."git@github.com:".insteadOf "https://github.com/" - 若用 SSH key，确保 runner 已挂载 key 并执行
eval $(ssh-agent)+ssh-add /path/to/key - 关键检查点：在 CI 日志里搜
git ls-remote输出，确认能拿到 commit；再搜Fetching，确认后续调用的是git+ssh而非https
模块作者改了仓库地址（如 org 迁移），但 go.sum 还锁着旧路径
比如模块原路径是 github.com/old-org/lib，后来迁移到 github.com/new-org/lib，作者发了新 tag，但没更新 go.mod 里的 module 声明。你的 go.sum 仍记着旧路径的哈希，go mod download 就会去旧地址拉 zip —— 而旧 repo 已设为 private 或 404，直接中断。
这种不能靠清理缓存解决，得手动对齐：
- 先用
go mod download -json github.com/old-org/lib@v1.2.0查看实际重定向目标（如果有的话） - 若重定向到了新地址，就在
go.mod里加replace github.com/old-org/lib => github.com/new-org/lib v1.2.0 - 再跑
go mod tidy，它会自动更新go.sum里的新路径哈希 - 注意：
replace只影响当前模块，不影响下游引用者；若要彻底迁移，需推动上游更新module声明
go mod verify 依然能过，因为校验只比对 go.sum 和缓存内容哈希，不检查来源协议是否有效。直到下次 go build 需要 re-download 或 update 依赖时，问题才暴露——那时往往已合并代码、触发 CI，排查成本陡增。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
