go mod tidy 一直报 404 GOPROXY 换 goproxy.cn 还是失败到底怎么查

现象

go mod tidy 一直报 404 Not Found,提示 module github.Com/xxx/yyy: reading HTTPs://proxy.golang.org/...: 404。换成国内源后公开包能下了,个别私有库仍然失败,构建始终卡在依赖阶段。

原因

GOPROXY 默认指向 proxy.golang.org,国内请求可能被拦或超时;404 一般表示代理上没有这个模块版本,常见于私有仓库、被删除的 tag,或者模块路径大小写与仓库实际地址不一致。

解决步骤

第一步,看清当前代理配置和报错里的完整模块路径。

go env GOPROXY GOSUMDB GOPRIVATE
go env -w GOPROXY=https://goproxy.cn,direct
go mod tidy -x

第二步,换国内代理并保留 direct 兜底。GOPROXY 用逗号分隔,前面失败会继续往后走;把私有库域名写进 GOPRIVATE,跳过代理和校验,再配好 git 的 SSH 凭据让 go 直接拉取。

第三步,核对模块路径和版本。打开报错里的 URL 看代理返回内容,确认 tag 是否存在、大小写是否与 go.mod 一致;老项目可临时用 GOFLAGS=-mod=mod 排除 vendor 目录的干扰。

验证

go mod tidy 不再报错,go list -m all 能列出全部依赖,go build 通过,GOPRIVATE 里的库走的是直连而不是代理,说明配置正确。

小结

Go 的 404 多来自代理不可达或路径不对。国内环境配 goproxy.cn 加 direct,私有库单独放行,比反复清缓存有效。

您可以还会对下面的文章感兴趣: