go模块代理重定向失败本质是goproxy返回非预期301/302响应，go客户端未按rfc规范处理location头导致路径错乱或无限跳转；需确保代理返回绝对uri且scheme/host与原始请求一致，否则客户端中止。
Go 模块代理重定向失败，本质是 GOPROXY 返回了非预期的 301/302 响应，而 Go 客户端未按规范处理 Location 头导致路径错乱或无限跳转——这不是网络问题，是代理服务端配置与 Go 客户端行为不匹配。
为什么 go get 会卡在重定向上
Go 的 go get 和 go mod download 在使用代理时，会把原始模块路径（如 github.com/user/repo）拼成代理 URL（如 https://goproxy.cn/github.com/user/repo/@v/v1.2.3.info）。如果代理返回 301/302，Go 客户端默认只重用原始请求方法（GET），但不会自动修正 Host、路径前缀或协议，尤其当 Location 值是相对路径（/foo/bar）或跨域绝对路径（http://other.proxy/...）时，就会触发 invalid URL 或 no module found 错误。
- 常见错误现象：
go: github.com/user/repo@v1.2.3: reading https://goproxy.cn/github.com/user/repo/@v/v1.2.3.info: 301 Moved Permanently后无后续，或直接报invalid version - 根本原因不是代理宕机，而是代理返回了 Go 不兼容的重定向响应：Location 缺少 scheme+host，或用了 HTTP 协议而客户端期望 HTTPS
- Go 官方要求代理必须返回 绝对 URI（RFC 7231 §7.1.2），且 scheme/host 必须与原始请求一致；否则视为无效重定向，客户端将中止
检查并修复 GOPROXY 配置本身
先确认你当前实际生效的代理地址是否正确，而不是仅看环境变量：
- 运行
go env GOPROXY，输出应为类似https://goproxy.cn,direct—— 注意逗号分隔，不能有空格 - 若用私有代理（如 Nexus、JFrog），确保其
proxy.golang.org兼容模式已开启，且反向代理配置中禁用proxy_redirect（Nginx）或等效设置，避免二次重定向 - 手动测试代理响应：
curl -I "https://goproxy.cn/github.com/gorilla/mux/@v/v1.8.0.info"，检查Location:头是否为完整 HTTPS 绝对 URL，且状态码是 200 而非 301/302 - 国内常用代理如
https://goproxy.cn或https://goproxy.io已稳定支持，不建议自行搭建未充分验证的中间代理
绕过代理重定向：用 replace + direct 强制走直连
当代理不可控（如企业内网镜像源配置错误）时，最稳的方式是跳过该模块的代理路径，改用 replace 指向本地或可信源，并显式启用 direct 回退：
- 在
go.mod中添加：replace github.com/bad/proxy-module => github.com/bad/proxy-module v1.2.3，然后运行go mod tidy - 临时禁用代理只针对某次操作：
GOPROXY=direct go get github.com/bad/proxy-module@v1.2.3 - 若需保留代理但让特定模块走 direct，可在
go env -w GOPROXY="https://goproxy.cn,direct"中确保direct在末尾，Go 会按顺序尝试，失败后自动 fallback - 注意：
replace不会改变go.sum校验目标——它仍校验原始模块路径的哈希，所以替换后务必确认源码内容一致
CI/CD 中重定向失败的隐藏陷阱
流水线里看似相同的命令，常因环境变量继承或 shell 解析差异导致代理失效：
- Docker 构建中，
ENV GOPROXY必须写在RUN之前，且不能被后续.bashrc覆盖；推荐在go build前加go env -w GOPROXY=https://goproxy.cn,direct - GitHub Actions 中，
env:下设置的GOPROXY对setup-goaction 无效，需在steps中显式go env -w - 若使用
go mod vendor，重定向失败会表现为cannot find module providing package—— 因为vendor生成依赖于go mod download成功，而后者卡在重定向上 - 最易忽略的一点：
GOSUMDB=off不能解决重定向问题，它只跳过校验；代理重定向失败发生在下载阶段，早于校验
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
