go mod download超时不会自动重试，需用bash脚本实现带指数退避的重试逻辑：timeout包裹命令、捕获网络类错误（如context deadline exceeded）、清缓存、间隔递增重试最多3次。
go mod download 超时后不会自动重试，得自己加逻辑
默认 go mod download 遇到网络抖动或代理不稳定时直接失败，退出码为 1，且不带重试机制。CI/CD 中常见报错是 Get "https://proxy.golang.org/...": net/http: request canceled while waiting for connection 或类似 context deadline exceeded，本质是底层 http.Client 默认超时（30s）被触发。
解决思路不是调大全局 timeout（Go 工具链不支持），而是用 shell 控制流程：
- 用
timeout命令包裹go mod download，主动设限（比如 120s），避免卡死 - 捕获退出码：非 0 就重试，最多 3 次，每次间隔递增（2s → 4s → 8s）
- 重试前清掉部分缓存（
go clean -modcache不推荐全清，太重；可选删失败模块的临时目录）
用 bash 实现带退避的重试，别依赖第三方工具
不用 retry 或 backoff 这类非标准命令，纯 bash 更可靠。关键点是：重试计数、指数退避、只对特定错误码重试（比如网络类，跳过 invalid version 这种语义错误）。
#!/bin/bash
max_retries=3
retry_delay=2
for i in $(seq 1 $max_retries); do
if timeout 120s go mod download; then
exit 0
fi
if [ $i -lt $max_retries ]; then
echo "go mod download failed (attempt $i), retrying in ${retry_delay}s..."
sleep $retry_delay
retry_delay=$((retry_delay * 2))
fi
done
exit 1注意：timeout 在 macOS 上叫 gtimeout（需 brew install coreutils），Linux 原生支持。CI 环境建议统一用 Linux 镜像，或加兼容判断。
立即学习“go语言免费学习笔记（深入）”；
GO111MODULE=on 和 GOPROXY 必须显式设置
很多构建脚本漏掉这两项，导致在 GOPATH 模式下 fallback，或走直连触发更频繁超时。尤其 Jenkins 或旧版 GitLab Runner 可能继承宿主环境变量，不可信。
-
GO111MODULE=on强制启用模块模式，避免go mod download误判项目结构 -
GOPROXY=https://proxy.golang.org,direct是安全底线；若内网有私有 proxy，写成GOPROXY=https://your-proxy.example.com,direct - 不要设
GOPRIVATE除非真有私有模块——它会绕过 proxy，反而增加超时风险
超时异常里混着真正的模块错误，得区分对待
重试不能无脑套用。比如 go mod download 报 module github.com/some/private/repo: reading https://api.github.com/...: 404 Not Found，重试 100 次也没用。真正要重试的只有明确含网络中断关键词的错误：
net/http: request canceledcontext deadline exceededi/o timeout-
connection refused或no route to host
其他错误（如校验和不匹配、版本不存在、private repo 权限拒绝）应立即失败。可在重试前用 grep -qE 过滤 stderr，只对上述关键词重试，否则直接 exit 1。
最麻烦的是 proxy 返回 503 但没带明确 timeout 提示——这种得靠 timeout 命令兜底，而不是等 Go 自己报错。
