无法配置Xcode Cloud，请求返回401 Unauthorized该如何解决？

1. 确认Apple ID的团队角色与权限 #

• 确保你的Apple ID在App Store Connect中拥有管理员或开发者角色，且所属团队匹配当前项目的开发团队。若为团队账号，联系管理员确认未限制你的Xcode Cloud访问权限。
• 登录App Store Connect，进入「用户和访问」页面，检查账号角色，必要时请求管理员调整权限。

2. 清理Xcode缓存与偏好设置 #

• 完全退出Xcode（包括后台进程），在终端执行以下命令清除缓存文件：

  rm -rf ~/Library/Caches/com.apple.dt.Xcode
  rm -rf ~/Library/Developer/Xcode/DerivedData
  rm -rf ~/Library/Preferences/com.apple.dt.Xcode.plist
  

• 重启Mac后重新打开Xcode，重新登录Apple ID和GitHub账号。

3. 重新关联GitHub授权权限 #

• 登录GitHub，进入「设置」→「应用程序」→「授权的OAuth应用」，找到「Xcode」并撤销授权，再回到Xcode中重新关联GitHub账号。
• 确认目标GitHub仓库的权限：你的GitHub账号需拥有仓库的读写权限，且仓库未设置IP白名单、组织权限拦截等额外限制。

4. 排查网络与代理干扰 #

• 暂时关闭所有代理工具（包括Proxyman），Xcode Cloud的API请求可能因代理配置异常导致认证失败。
• 切换至稳定的网络环境（如手机热点），避免公司防火墙或VPN拦截Apple的API请求。

5. 手动验证API密钥有效性 #

• 在App Store Connect中生成新的API密钥（路径：「用户和访问」→「密钥」→「生成API密钥」），确保密钥勾选「CI/CD」权限。
• 使用curl命令测试API请求，替换YOUR_JWT_TOKEN、TEAM_ID和BUNDLE_ID：

  curl -H "Authorization: Bearer YOUR_JWT_TOKEN" https://appstoreconnect.apple.com/ci/api/teams/TEAM_ID/apps/find?bundle_id=BUNDLE_ID
  

  • 若返回401，说明密钥权限不足或Team ID/Bundle ID填写错误；
  • 若返回正常数据，说明Xcode内部Token生成存在问题，需重新关联账号。

6. 重置钥匙串中的Apple ID凭据 #

• 打开「钥匙串访问」，搜索「Apple ID」或「App Store Connect」，删除相关的密码和证书条目。
• 重新打开Xcode，登录Apple ID时选择「允许」访问钥匙串。

7. 更新Xcode至最新版本 #

• 旧版Xcode可能存在Xcode Cloud的认证漏洞，前往App Store或Apple开发者官网下载安装最新版Xcode。

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