从XCode登录Bitbucket Cloud提示权限错误的原因及解决办法

可能的原因 #

• 应用密码权限范围不匹配：SourceTree使用的应用密码可能只申请了仓库操作权限，但Xcode认证时需要额外的账户级权限（比如读取账户信息、访问特定API端点），导致权限不足。
• 认证逻辑差异：Xcode与SourceTree调用Bitbucket API的方式不同，适配SourceTree的应用密码权限不一定能满足Xcode的认证要求。
• 本地凭据缓存冲突：Xcode本地钥匙串中存储了旧的Bitbucket凭据，和当前应用密码冲突，引发认证失败。
• 仓库权限不足：你尝试访问的Bitbucket私有仓库，当前账号未被添加为成员，或没有对应的读写权限。

解决步骤 #

1. 重新生成适配Xcode的应用密码 #

• 登录Bitbucket网页端，进入个人设置 → 应用密码
• 点击“创建应用密码”，勾选以下必要权限：
  • 仓库：读写
  • 账户：读取
• 保存生成的新密码（注意：密码仅显示一次，务必复制留存）

2. 清除Xcode的本地凭据缓存 #

• 打开Mac的钥匙串访问应用
• 在搜索框输入“Bitbucket”，删除所有相关的密码条目
• 重启Xcode，进入“设置 → 账户”，删除已有的Bitbucket账户后重新添加，使用新生成的应用密码登录

3. 验证仓库权限 #

• 登录Bitbucket网页端，找到目标仓库
• 进入仓库的“设置 → 权限”，确认你的账号在成员列表中，且拥有至少读写权限

4. 检查Xcode账户配置 #

• 打开Xcode，点击顶部菜单栏的“Xcode → 设置 → 账户”
• 删除现有的Bitbucket账户，点击“+”重新添加，选择“Bitbucket”类型
• 输入Bitbucket用户名和新生成的应用密码完成登录

内容的提问来源于stack exchange，提问作者Burak Dürmer