go mod download卡在私有Git地址上是因Go工具链直连该地址而不走GOPROXY，需配GONOPROXY和GONOSUMDB成对生效，并确保Git服务可达或启用内网代理缓存。
go mod download 卡在某个私有 Git 地址上
这不是代理问题，而是 Go 工具链在解析 go.mod 里声明的私有模块路径（比如 gitlab.example.com/my/lib）时，直接发起 DNS 查询和 TCP 连接，不走 GOPROXY。一旦该 Git 服务临时不可达（如 CI/CD 平台维护、DNS 切换、SSL 证书轮换），go mod download 就会卡住几十秒甚至超时失败。
验证方式：加 -v 参数运行 go mod download -v，看到类似 Fetching https://gitlab.example.com/my/lib/@v/list 或 dial tcp 10.20.30.40:443: connect: connection refused 的日志，基本可确认是目标 Git 服务抖动。
- 临时缓解：用
GIT_TERMINAL_PROMPT=0避免交互式凭据卡住（尤其 HTTPS 克隆场景） - 更可靠的做法是提前配置
GONOPROXY和GONOSUMDB成对生效，例如：go env -w GONOPROXY="gitlab.example.com"+go env -w GONOSUMDB="gitlab.example.com" - 若使用 SSH 克隆，确保
ssh -T git@gitlab.example.com能通；若用 HTTPS，建议配好git config --global credential.helper store，避免每次拉取都弹认证
go get 安装工具时因 golang.org/x 路径直连失败
go get 在 Go 1.16+ 已被标记为 deprecated，但它仍会绕过 GOPROXY 直连 golang.org 域名——而这个域名在国内多数时间无法解析或 TLS 握手失败。现象是 go get golang.org/x/tools/gopls 卡在 Fetching https://golang.org/x/tools/@v/list，哪怕你已设好 GOPROXY 也无效。
根本解法不是换镜像，而是切换命令：
- 改用
GO111MODULE=on go install golang.org/x/tools/gopls@latest（Go 1.16+ 推荐） - 如果仍失败，手动替换路径：把
golang.org/x/tools改成github.com/golang/tools，再执行go install github.com/golang/tools/gopls@latest - 注意：后者需同步修改代码中所有
import "golang.org/x/tools/..."为import "github.com/golang/tools/..."，仅限临时调试
模块 checksum 校验阶段因 sum.golang.org 不可达中断
即使依赖下载成功，go mod download 后还会去 sum.golang.org 查校验和。该服务在国内常出现间歇性不可达，报错如 verifying github.com/some/pkg@v1.2.3: checksum mismatch 或 Get "https://sum.golang.org/lookup/...": dial tcp: i/o timeout。
这不是模块本身损坏，而是校验服务失联导致的假失败：
- 临时方案：关闭校验
go env -w GOSUMDB=off（开发环境可用，CI 环境慎用） - 稳妥方案：换校验源，例如
go env -w GOSUMDB=sum.golang.org+replace=gosum.io+ca=trusted - 清理缓存后重试：
go clean -modcache，再跑go mod download
企业内网 Git 服务短暂失联时如何避免阻塞构建
当私有 Git 服务（如自建 GitLab、Gitea）因升级、备份或网络抖动短暂不可达，CI 流水线里的 go build 可能直接失败。关键在于区分“必须拉取”和“可缓存复用”：
- 确保
$GOPATH/pkg/mod/cache/download/目录在 CI 中持久化，避免每次构建都重新拉取 - 对稳定版本的私有模块，在
go.mod中显式指定 commit hash 或语义化版本（而非master或main分支），减少动态解析依赖 - CI 脚本中加入重试逻辑：例如
for i in {1..3}; do go mod download && break || sleep 5; done - 长期建议：在内网部署
athens或goproxy本地代理，把私有模块缓存前置，隔离外部服务波动
真正麻烦的不是某次超时，而是把私有域名漏加进 GONOPROXY 导致所有请求都被转发到公共镜像——这时候 Git 服务一抖，整个依赖链就断了，且错误日志里根本看不出是路由错了还是真连不上。
