go模块拉取失败主因是goproxy配置被环境变量、go env或vendor机制覆盖或绕过，需检查go env goproxy输出、vendor目录存在性、ide独立环境及gosumdb校验阻塞，并通过调试日志验证真实请求路径是否走代理。

Go 模块拉取失败，八成不是网络问题，而是 GOPROXY 配置被本地环境变量、go env 或 vendor 机制意外覆盖或绕过。

为什么 go get 明明设置了代理却还报 403 Forbidden 或 timeout

Go 在模块模式下会按固定优先级读取代理配置：环境变量 > go env -w GOPROXY=... > go.mod 中的 replace / exclude > vendor 目录是否存在。一旦某处显式禁用或跳过代理（比如设为 direct），后续所有模块请求都会直连源站——而多数国内用户直连 proxy.golang.org 或 goproxy.io 会被拦截或限速。

• 检查是否在项目根目录下存在 vendor 文件夹：有则 go get 默认不走代理，除非加 -mod=mod
• 运行 go env GOPROXY，确认输出不是 off 或 direct；若为空，说明没生效
• 某些 IDE（如 VS Code 的 Go 插件）会独立设置 GOROOT 和 GOENV，导致终端里生效的配置在编辑器内无效
• 公司内网可能部署了透明代理或 DNS 劫持，即使 GOPROXY 正确，go list -m all 仍可能因解析 sum.golang.org 失败而卡住

如何验证当前 GOPROXY 是否真正生效

不能只看 go env GOPROXY，要观察真实 HTTP 请求路径。最直接的方式是启用 Go 的调试日志：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

GO111MODULE=on GOPROXY=https://goproxy.cn,direct GOSUMDB=off go get -v github.com/go-sql-driver/mysql@v1.14.0

注意三点：

• 必须显式拼接 direct 作为 fallback，否则遇到私有模块时会直接失败
• 加上 GOSUMDB=off 可绕过校验服务器（临时排查用，生产环境应配 https://goproxy.cn 对应的 sumdb）
• 观察终端输出中是否出现 Fetching https://goproxy.cn/github.com/go-sql-driver/mysql/@v/v1.14.0.info —— 出现才代表真正在走代理
• 若看到 Fetching https://proxy.golang.org/...，说明配置被某处覆盖，需逐层排查 go env -u GOPROXY 或 shell 启动脚本里的 export

Nginx 反向代理自建 GOPROXY 时最容易漏掉的响应头

如果你用 Nginx 做了一层私有代理（比如指向 https://goproxy.cn），但下游 go get 仍频繁 404 或 502，大概率是 Nginx 没透传关键 header 或缓存了错误响应。

• 必须添加 proxy_set_header Host $host;，否则上游 goproxy.cn 无法识别子路径语义
• 必须关闭缓存：proxy_cache off;，Go 客户端对 302 重定向和版本元数据响应极其敏感，缓存会导致 .info / .mod 文件返回旧内容
• 需要透传原始状态码：proxy_intercept_errors off;，否则 Nginx 把上游 404 转成自己的 502，go 工具链无法正确处理
• 建议加 proxy_buffering off;，避免大体积 .zip 包被截断

真正麻烦的从来不是设一个 GOPROXY 地址，而是当多个上下文（shell、IDE、CI 脚本、Docker 构建阶段）各自维护一套配置时，哪一处悄悄关掉了代理，你根本不会立刻发现——直到某天 go test 突然超时，或者 CI 流水线在拉某个次要依赖时卡死三分钟。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！