安装BitBucket私有Python包遇重定向超30次EnvironmentError如何解决

报错原因确认 #

该Exceeded 30 redirects报错确实和BitBucket私有仓库的鉴权逻辑相关：你使用HTTPS链接直接安装时，pip无法自动处理私有仓库的身份校验，BitBucket会持续重定向到登录页面，最终超过重定向次数上限触发报错。

解决方法 #

方案1：使用SSH协议安装（推荐，无需重复输入密码） #

如果你本地已经配置过BitBucket的SSH密钥，直接使用SSH格式的仓库地址安装即可，命令如下：

pip install git+ssh://git@bitbucket.org/myteam/toolbox.git

如果需要安装特定分支、标签或者提交版本，在地址后追加对应的引用即可，例如安装main分支的版本：

pip install git+ssh://git@bitbucket.org/myteam/toolbox.git@main

方案2：携带鉴权信息的HTTPS协议安装 #

如果你需要临时使用HTTPS方式安装，需要先在BitBucket个人设置中创建专门的应用密码（不要使用账号登录密码，BitBucket已不支持登录密码用于Git操作鉴权），并为该应用密码开启仓库读取权限，之后使用如下格式的命令安装：

pip install git+https://<你的BitBucket账号>:<你的应用密码>@bitbucket.org/myteam/toolbox.git

注意：该方式会在命令行历史中留存你的密码信息，仅推荐临时使用，不要在共享设备上操作。

方案3：全局配置私有仓库鉴权（适合频繁安装同组私有包） #

如果你需要经常安装该团队下的私有Python包，可以将鉴权信息配置到pip全局配置文件中，简化后续安装操作：

1. 编辑Mac端pip配置文件~/.pip/pip.conf，新增如下内容：

[global]
extra-index-url = https://<你的BitBucket账号>:<你的应用密码>@bitbucket.org/myteam/toolbox.git

2. 后续直接执行以下命令即可完成安装：

pip install toolbox

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