Go模块下载失败时不会自动fallback，必须配置GOPROXY为逗号分隔的多代理（如https://goproxy.cn,https://proxy.golang.org,direct），但仅404错误才触发下一代理，403/502/timeout等直接报错；推荐使用goproxy工具实现真重试或CI中加兜底逻辑。
Go模块下载失败时如何触发备用代理源
Go 1.13+ 默认使用 proxy.golang.org，但国内访问常因网络策略返回 403 Forbidden 或超时（net/http: request canceled），此时 Go 不会自动 fallback——它根本没 fallback 机制。必须靠外部手段干预。
核心思路：不依赖 Go 自动切换，而是用环境变量或工具层做“前置路由”，让失败请求在发起前就走备用源。
-
GOPROXY支持逗号分隔的多个代理，Go 会按顺序尝试，**遇到非 404/200 响应即终止并报错，不会继续试下一个**（注意：不是所有错误都跳过，比如 403、502、timeout 都算失败，不会 fallback） - 真正有效的 fallback 需要中间层拦截：比如用
goproxy.cn作为主代理，它本身已内置对proxy.golang.org的兜底；或自建反向代理，内部实现重试逻辑 - 最轻量方案是设置
GOPROXY=https://goproxy.cn,direct——direct表示最后回源到原始模块地址（如 GitHub），但要求模块支持 HTTPS 且未被墙，成功率有限
为什么 GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct 不起作用
很多人误以为逗号分隔 = 自动重试链，实际 Go 的行为是：对每个模块 URL，只向第一个非 direct 代理发一次请求；若返回 404（not found），才尝试下一个；若返回 403、502、timeout 等，直接报错退出，**绝不会查第二个代理**。
典型错误现象：go get: module golang.org/x/net@v0.23.0: reading https://proxy.golang.org/golang.org/x/net/@v/v0.23.0.info: 403 Forbidden —— 此时哪怕你写了两个代理，Go 也不会发请求到 goproxy.cn。
- 验证方式：临时设
GOPROXY=https://proxy.golang.org，执行go get -v golang.org/x/net，观察是否卡在 403；再换GOPROXY=https://goproxy.cn，看能否成功 -
direct只在代理返回 404 时启用，且要求模块仓库公开可直连（如 GitHub 上的 public repo），私有模块或被重定向的地址会失败 - 某些企业网络会劫持 HTTPS 请求，导致代理返回非标准错误码（如 000 或空响应），Go 同样不重试
用 goproxy 工具实现真 fallback
官方 go 命令不支持动态 fallback，但开源工具 goproxy（非 goproxy.cn）可启动本地代理服务，内部配置多源优先级和重试策略。
实操步骤：
- 安装：
go install github.com/halfrost/goproxy@latest - 启动本地代理：
goproxy -p :8080 -r "https://goproxy.cn" -b "https://proxy.golang.org"，其中-r是主源，-b是备用源（当主源返回非 2xx 时，自动用备用源重试） - 设置：
GOPROXY=http://localhost:8080，所有go get请求先打到本地服务，由它决定走哪条链路 - 注意：
goproxy默认不缓存，如需加速，加-c /path/to/cache参数
CI/CD 中稳定处理模块拉取失败
自动化流程里不能依赖人工干预，必须预设容错路径。单纯改 GOPROXY 环境变量不够，得结合超时控制和降级动作。
- 在 CI 脚本中加兜底逻辑：先设
GOPROXY=https://goproxy.cn，运行go mod download；若失败（$?非 0），再设GOPROXY=https://proxy.golang.org,direct重试一次 - 避免
go clean -modcache后重下全部模块——改用go mod download -x查看具体哪个模块失败，针对性处理 - 私有模块务必用
replace或GONOSUMDB配合，否则即使代理正常，校验也会因 checksum mismatch 失败
真正的难点不在配置开关，而在识别“失败”类型：是网络中断、权限拒绝，还是模块不存在？不同原因需要不同应对，而 Go 的错误输出往往模糊，得靠日志关键词（403、timeout、no required module）做条件分支。
