goproxy通过http请求（如/@v/v1.14.0.info）决定模块解析路径：先向代理查询，200则采用其响应版本，404/5xx时fallback至direct；私有模块需配置goprivate绕过代理，否则因未索引而报错module not found。
goproxy 代理如何改变 go mod download 的模块解析路径
Go 模块下载不再只看本地 go.sum 和 go.mod，而是先向 GOPROXY 发起 HTTP GET 请求，路径形如 https://proxy.golang.org/github.com/go-sql-driver/mysql/@v/v1.14.0.info。如果代理返回 200，就跳过直接访问源仓库（如 GitHub）；返回 404 或 5xx，则 fallback 到 direct 模式（前提是 GOPROXY 配置含 direct）。
关键点在于：代理不是“缓存镜像”，而是“权威响应源”。它决定哪些版本存在、哪些被重定向、哪些被拒绝（比如私有模块未授权时返回 403）。
-
GOPROXY=https://proxy.golang.org,direct表示：先查代理，失败再直连 -
GOPROXY=https://goproxy.cn（无direct）表示：所有请求必须由该代理响应，失败即报错 - 若代理返回的
.info中Version字段与go.mod声明不一致（例如返回 v1.13.0 而你 require v1.14.0），go mod download会失败并提示unexpected module path
私有模块在 GOPROXY 下为何常出现 module not found
公共代理（如 proxy.golang.org）默认不索引私有域名（如 git.internal.company.com）。即使你在 go.mod 里写了 replace 或 replace + exclude，只要 GOPROXY 不支持该 host，go mod tidy 就会在解析依赖图时卡在第一步 —— 获取 @v/list。
真正生效的解法不是“加 replace”，而是让代理知道“这个域名要绕过”：
- 设置
GOPRIVATE=git.internal.company.com：告诉 Go 工具链，对该域名禁用代理，强制直连 - 若使用企业级代理（如 Athens、JFrog），需手动配置其
allowedHosts或restrictedMode白名单 - 错误做法：把私有模块 URL 写成
https://git.internal.company.com/repo@v1.2.3并期望代理能解析 —— 实际上代理根本不会尝试请求该 URL，因为域名不在其索引范围内
go get -u 升级时，goproxy 返回的 @latest 版本为什么和 tag 不一致
@latest 不是简单取最新 tag，而是由代理根据模块的 go.mod 文件中 module 声明 + 语义化版本规则 + 分支策略综合计算。例如：
module github.com/example/lib go 1.19
若该仓库有 tag v1.2.0、v2.0.0（带 major version bump），但 v2.0.0 的 go.mod 中写的是 module github.com/example/lib/v2，那么 @latest 仍会返回 v1.2.0 —— 因为 v2 是不同 module path。
- 代理不会自动升级到
v2，除非你显式go get github.com/example/lib/v2@latest - 某些代理（如 goproxy.cn）对无
go.mod的仓库会 fallback 到 latest commit，导致@latest返回 commit hash 而非 tag - 运行
curl https://proxy.golang.org/github.com/example/lib/@latest可直接看到代理返回的 JSON，字段Version就是go get -u实际采用的值
多级代理链（如 CDN → 企业 proxy → upstream）引发的校验失败
当请求经过多层中间件（比如 Nginx 缓存、CDN、反向代理），容易出现 go.sum 校验失败，错误信息类似：verifying github.com/sirupsen/logrus@v1.9.0: checksum mismatch。根本原因不是内容被篡改，而是某一层代理修改了响应体（如 gzip 压缩、添加 header、截断 body）或缓存了旧版 .mod/.zip 文件。
- 最常见：CDN 缓存了
.info或.mod，但没随上游更新而刷新，导致go mod download下载的 zip 与本地记录的 hash 不匹配 - 解决方式：在代理层显式禁用缓存这些路径（
*@*.info、*@*.mod、*@*.zip） - 调试技巧：对比
curl -I https://your-proxy/github.com/xxx/@v/v1.2.3.zip的Content-Length和官方源是否一致；再curl -s https://your-proxy/xxx/@v/v1.2.3.mod | sha256sum核对 hash
@latest 解析逻辑隐含时，哪一层悄悄覆盖了你的预期。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
