Windows下go mod tidy拉取Bitbucket私有仓库报404问题咨询

Go工具链拉取依赖时，会先判断目标仓库是否属于私有仓库：

• 如果目标域名/路径不在GOPRIVATE配置列表中，Go会默认走公共模块代理拉取，拉取失败时会自动请求Bitbucket公开API查询仓库的SCM类型（Git/Hg），这个API请求默认不会携带你本地的Git认证凭证，访问私有仓库时就会返回404错误。
• 你之前配置的git config insteadOf规则不生效，是因为流程根本没走到调用本地Git克隆仓库的步骤，在前置API请求阶段就已经报错中断了。
• 同团队Linux同事可以正常拉取，是因为他们本地已经配置了GOPRIVATE规则，Go会跳过公共代理、跳过API校验步骤，直接调用本地Git执行克隆操作，全程不会访问api.bitbucket.org域名。

按照以下顺序操作即可解决问题：

1. 配置私有仓库规则，让Go跳过API校验和公共代理
   打开PowerShell或CMD执行以下命令，把你的Bitbucket工作空间路径加入私有仓库列表：

   go env -w GOPRIVATE=bitbucket.org/myworkspace/*
   

   如果团队所有私有仓库都托管在Bitbucket上，可以直接配置为bitbucket.org/*匹配所有Bitbucket路径。

2. 配置Git克隆规则和认证，根据你使用的协议二选一即可：

   • SSH协议（推荐）：
     先把你本地的SSH公钥上传到Bitbucket账号的SSH密钥管理页面，之后执行Git配置，把HTTPS请求重写为SSH地址：

     git config --global url."git@bitbucket.org:".insteadOf "https://bitbucket.org/"
     

   • HTTPS协议：
     先在Bitbucket个人设置中生成有仓库读权限的App密码（注意不能用账号登录密码，Bitbucket已不支持HTTPS克隆用登录密码认证），之后执行Git配置，把用户名和App密码写入URL重写规则：

     git config --global url."https://<你的Bitbucket用户名>:<生成的App密码>@bitbucket.org/".insteadOf "https://bitbucket.org/"
     

3. 清理缓存验证效果
   先清除本地旧的模块缓存，避免之前的错误缓存影响结果：

   go clean -modcache
   

   之后重新执行go get或go mod tidy命令即可正常拉取私有依赖。

• 如果配置完成后还是会请求Bitbucket API，检查Windows系统环境变量中是否手动设置了GOPRIVATE或GOPROXY覆盖了go env -w写入的配置，确保go env GOPRIVATE的输出中包含你的Bitbucket私有仓库路径。
• 如果开启了系统代理，需要把bitbucket.org加入代理的忽略列表，避免请求被代理拦截导致认证失败。

内容的提问来源于stack exchange，提问作者KristianMedK