go mod download卡住并非因缺乏重试机制，而是单次请求超时后即放弃；根本解法是确保GOPROXY=https://goproxy.cn,direct并配置GOSUMDB=sum.golang.google.cn等可用校验源，避免sum.golang.org连接失败阻塞流程。
go mod download 卡住时，重试不是靠多试几次
默认的 go mod download 不会自动重试失败的模块请求，它只会在首次连接超时后放弃——这不是“没重试”，而是根本没设计重试逻辑。你看到的“卡几秒再报错”，其实是底层 HTTP 客户端在等待 TLS 握手或 TCP 连接建立，属于单次请求超时，而非重试机制生效。
真正起作用的是代理服务本身的容错能力，比如 goproxy.cn 对 502/504 会内部重试上游源，但 Go 工具链本身不参与这一层。所以优化方向不是给 go 命令加重试开关（它没有），而是让每次请求更大概率成功。
- 确保
GOPROXY设为https://goproxy.cn,direct，,direct是关键兜底项，避免私有模块因代理不可达而卡死 - 禁用系统级 DNS 缓存干扰：Windows 上运行
ipconfig /flushdns，macOS/Linux 执行sudo dscacheutil -flushcache或sudo systemd-resolve --flush-caches - 弱网下避免并发拉取：
go mod download -x调试时观察是否多个模块同时发起请求；可临时设GOMODCACHE到 SSD 盘并预热缓存：go mod download all拉一次，后续构建基本不走网络
为什么不能用 backoff 库包装 go get
第三方重试库（如 github.com/cenkalti/backoff/v4）适用于你写的 HTTP 客户端代码，但对 go 命令无效。因为 go get 和 go mod download 是 Go 工具链二进制程序，不暴露可编程接口，也无法注入自定义重试策略。
强行在 shell 层面写循环重试（比如 until go mod download; do sleep 2; done）反而有害：
立即学习“go语言免费学习笔记（深入）”；
- 每次调用都重新解析
go.mod、检查校验和、发起新 HTTP 请求，放大弱网压力 - 可能触发
GOSUMDB的多次校验失败，导致sum.golang.org被反复探测，加剧超时 - 无法区分“模块不存在”和“网络超时”，容易无限重试 404 错误
GOSUMDB 校验失败才是弱网下真正的卡点
很多人以为慢在下载，实际日志里最常卡在 verifying github.com/some/pkg@v1.2.3: checksum mismatch 或直接 dial tcp 142.251.42.241:443: connectex: A connection attempt failed ——这个 IP 就是 sum.golang.org。GOSUMDB 默认开启且强制校验，一旦连不上，整个下载流程就阻塞。
解决方案不是关掉校验（不安全），而是换可用的校验服务：
- 设
GOSUMDB=sum.golang.google.cn（官方中国镜像，比sum.golang.org稳定得多） - 若公司有内网 Nexus/Artifactory，配置为
GOSUMDB=http://nexus.example.com/repository/gosumdb - 私有模块必须同步设
GONOSUMDB，值与GONOPROXY完全一致，否则即使代理通了，校验也会拒绝直连模块
调试时如何确认重试有没有发生
别信 go env GOPROXY 输出，那只是配置；要确认实际行为，必须开调试日志：
运行 go mod download -x github.com/gin-gonic/gin@v1.9.1，重点看输出里有没有重复出现同一 URL 的 GET 请求行。如果只出现一次 GET https://goproxy.cn/.../@v/v1.9.1.info，然后就报错，说明没重试；如果看到两次以上相同请求，才是真正在重试（极少见，通常意味着代理节点异常）。
更常见的“伪重试”现象是：
- 第一次请求走
goproxy.cn失败，自动 fallback 到direct，接着尝试git clone——这不算重试，是代理链降级 -
go list -m -u all中某个模块反复出现在不同轮次输出里，其实是 Go 在遍历依赖图，并非重试
弱网下最有效的“重试”，其实是减少单次请求失败概率：固定 DNS（如 114.114.114.114）、关闭代理软件劫持、用 curl -v https://goproxy.cn 验证基础连通性——这些比任何代码层重试都管用。
