未启用Bitbucket 2FA却触发验证错误的问题排查

我之前帮不少开发者解决过这类困惑——明明自己的Bitbucket账户没开两步验证（2FA），甚至新注册的干净账户也碰到remote: Two-step verification is enabled for this account的错误，这大概率不是你个人账户的问题，而是下面几个常见原因导致的：

可能的原因 #

• 仓库所属工作区（Workspace）强制开启了2FA：Bitbucket的工作区管理员可以设置「要求所有成员开启2FA」，哪怕你自己的账户没开，只要你在这个工作区里，访问仓库就会触发验证要求。
• 本地Git缓存了旧账户凭据：之前可能用其他开启2FA的Bitbucket账户访问过仓库，本地Git保存了旧的凭据，导致现在用新账户访问时出现身份混淆。
• SSH密钥关联了其他开启2FA的账户：如果你的本地SSH密钥绑定过另一个开启2FA的Bitbucket账户，现在用这个密钥访问新账户的仓库，也会触发错误提示。
• Bitbucket系统缓存或临时故障：偶尔平台会有缓存延迟，导致账户状态没有及时同步。

对应的解决方案 #

1. 检查工作区的2FA强制设置 #

进入你要访问的仓库所属的工作区页面，点击右上角的设置图标，找到Security下的Two-step verification选项，查看是否开启了「Require two-step verification for all workspace members」。如果是，你需要为自己的账户开启2FA才能访问该工作区的仓库——这是工作层面的强制要求，和个人账户初始设置无关。

2. 清理本地Git凭据 #

根据你的操作系统清理旧凭据：

• Windows：打开「凭据管理器」，找到“Windows凭据”里和Bitbucket相关的条目，删除后重新输入当前账户的凭据。
• Mac：打开「钥匙串访问」，搜索“Bitbucket”，删除相关的密码条目，之后Git会重新提示你输入账户信息。
• Linux：执行命令git config --global --unset credential.helper清除全局凭据助手，或者找到对应的凭据存储文件删除相关条目。

3. 检查并更换SSH密钥 #

如果你用SSH方式访问仓库：

• 查看本地当前使用的SSH密钥：执行cat ~/.ssh/id_rsa.pub（默认密钥路径），复制公钥到Bitbucket当前账户的SSH密钥设置页面，确认这个密钥只绑定到当前未开2FA的账户。
• 如果之前的密钥绑定了其他账户，生成新的SSH密钥：ssh-keygen -t rsa -b 4096 -C "your-email@example.com"，然后将新的公钥添加到当前Bitbucket账户，之后用新密钥访问仓库。

4. 刷新会话与等待系统同步 #

• 退出Bitbucket的所有登录会话，清除浏览器缓存和Cookie，重新登录账户。
• 如果是临时系统缓存问题，等待10-15分钟后再尝试访问仓库，看是否恢复正常。

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