Xcode切换Apple ID报App ID超限 无法匹配描述文件真机调试

故障现象 #

• 原项目绑定个人Apple ID开发，迁移至公司Apple ID时Xcode弹出两类报错：

  Your maximum App ID limit has been reached. You may create up to 10 App IDs every 7 days.
  Xcode couldn't find any iOS App Development provisioning profiles matching 'com.example.interNation'.

• 项目可在iOS模拟器正常启动运行，但无法安装到真机完成调试。

注：模拟器运行不需要校验代码签名配置，因此该故障和项目代码无关，仅需修复签名链路即可。

分步解决方案 #

1. 解决App ID每周创建数量超限问题 #

这个报错是因为苹果开发者账号对自动创建App ID有配额限制，每7天最多新建10个，触发后Xcode自动签名流程会直接中断，进而连带触发找不到描述文件的报错。

• 先登录苹果开发者后台，进入公司账号的Certificates, Identifiers & Profiles列表，搜索Bundle ID com.example.interNation：
  • 如果后台已存在同Bundle ID的App ID：直接回到Xcode项目的Signing & Capabilities面板，取消勾选Automatically manage signing，手动选中已存在的App ID，再匹配对应开发证书和描述文件即可，不要让Xcode重复创建。
  • 如果后台不存在对应App ID：有三种处理方式：
    • 临时修改项目Bundle ID（比如原ID后加后缀.debug），绕过配额限制先跑通真机调试，等7天配额重置后再改回正式Bundle ID补全配置
    • 用公司账号的持有人权限联系苹果开发者支持，申请临时提升App ID创建配额，一般1-2个工作日会处理
    • 等7天配额自动重置后再操作，期间不要反复点击自动签名，每触发一次自动签名就会消耗一次创建配额，只会延长等待时间

2. 解决找不到匹配开发描述文件问题 #

• 打开Xcode设置的Accounts页，确认已登录公司Apple ID，且账号已加入对应开发团队、具备开发证书权限。选中公司团队后点击Manage Certificates，检查本地是否存在有效的iOS Development证书，没有的话点击左下角加号直接创建。
• 清理本地过期/无效的描述文件缓存：打开Finder按Command+Shift+G，输入路径~/Library/MobileDevice/Provisioning Profiles/，清空该文件夹下所有文件，重启Xcode。
• 回到Signing & Capabilities面板，重新勾选Automatically manage signing，选中正确的开发团队，等待Xcode自动拉取、生成对应描述文件。如果自动拉取失败，选中Accounts页的公司账号，点击Download Manual Profiles强制拉取最新配置。
• 如果采用手动签名，直接在开发者后台生成对应App ID的开发描述文件，绑定已有的开发证书和测试真机UUID，下载后双击导入Xcode，再在Signing面板选中对应文件即可。
• 真机额外检查：确认连接的真机UUID已经录入公司开发团队的设备列表，设备系统版本不低于项目设置的最低部署版本，首次连接时在真机上点击「信任」该电脑。

内容的提问来源于stack exchange，提问作者Sulaymon Ne'matov