go proxy健康检查失败时go mod download会静默降级，即代理超时或返回5xx/部分4xx时自动fallback至下一代理或direct，不报错；需通过手动请求@v/{mod,info,zip}、检查content-type与响应体、运行go list -m -json all验证origin.url及用curl+unzip校验实际服务能力来真实监控代理稳定性。
Go proxy 健康检查失败时 go mod download 会静默降级，不是所有错误都报错
Go 的模块代理（如 https://proxy.golang.org 或私有 athens）默认不主动探测健康状态。当代理响应超时、返回 5xx 或部分 4xx（比如 429 Too Many Requests）时，go 命令不会中断构建，而是自动 fallback 到下一个代理（如果有），或直接回退到源仓库（direct）。这意味着你可能在 CI 中反复拉取慢速/失效代理的模块，却看不到明显报错。
真正需要监控的，是代理是否「稳定提供正确响应」——不只是能连通，还要能返回合法的 .mod、.info 和 .zip 内容。建议用以下方式验证：
- 手动发起三类请求：
GET https://proxy.example.com/github.com/go-sql-driver/mysql/@v/v1.14.0.mod、@v/list、@latest - 检查响应头：
Content-Type是否为text/plain; charset=utf-8（.mod/.info）或application/zip（.zip） - 检查响应体是否包含预期字段，例如
.mod文件必须含module行，.info必须是合法 JSON 且含Version和Time
用 go list -m -json all 暴露代理实际行为，而非依赖 go env GOPROXY
go env GOPROXY 只显示配置值，但 Go 实际行为受环境变量组合影响更大。真正决定代理链的是：GOPROXY（逗号分隔列表）、GONOPROXY（跳过代理的路径匹配）、GOPRIVATE（等价于 GONOPROXY，但影响 go 命令对私有模块的认证逻辑）。
执行 go list -m -json all 时，Go 会真实触发模块解析，并在输出中带出每个模块的 Origin 字段（如 "Origin":{"URL":"https://proxy.golang.org"}），这才是代理实际被选用的证据。如果某模块没走代理，说明它命中了 GONOPROXY 规则，或代理返回了 404 且 fallback 成功——后者容易被忽略。
- 运行前确保工作目录下有
go.mod，否则all不生效 - 加
-mod=readonly避免意外写入go.sum - 若输出中大量模块的
Origin.URL为空或指向direct，说明代理未生效或持续失败
私有 Athens 代理的 /health 端点不可信，需额外校验模块服务能力
Athens 提供 GET /health 返回 {"status":"ok"}，但这只表示进程存活、数据库可连，不代表模块服务就正常。常见故障包括：缓存后端（如 S3）权限失效、磁盘满导致 zip 生成失败、上游代理（如 proxy.golang.org）被墙后未配置 fallback。
生产环境中必须绕过 /health，直接测试模块交付链路：
- 用
curl -I https://athens.example.com/github.com/gorilla/mux/@v/v1.8.0.zip查看HTTP/2 200和Content-Length > 0 - 下载后校验 ZIP 完整性：
unzip -t downloaded.zip >/dev/null - 对高频模块（如
golang.org/x/...）做定时探针，避免只测单个冷门包
CI 中禁用 direct fallback 才能暴露代理问题
默认 GOPROXY="https://proxy.golang.org,direct"，意味着代理挂了也会悄悄走源仓库，掩盖问题。CI 流水线里应强制关闭 fallback：
- 设置
GOPROXY="https://your-proxy.example.com"（单地址，无direct） - 配合
GO111MODULE=on和GOSUMDB=off（避免 sumdb 请求干扰） - 捕获明确错误：
go mod download失败时退出码非 0，且错误含proxy returned 503、no matching versions或unexpected status code 403
注意：这样配置后，CI 会因代理故障而失败，但这是你想要的——宁可构建中断，也不能让不可靠代理污染依赖来源。
真正难处理的不是代理宕机，而是它半死不活：响应延迟高、偶发 500、返回截断的 .mod。这类问题必须靠持续采样 + 响应体校验才能发现，光看 HTTP 状态码远远不够。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
