使用fastlane match生成iOS证书提示已达最大数量上限问题咨询

1. 无法生成Distribution证书的原因及iOS证书环境限制 #

• 苹果开发者账号对Distribution证书的数量有官方硬性上限：个人/组织类账号最多可创建2个，企业级账号最多可创建3个。你遇到的报错是因为苹果开发者后台已有的Distribution证书已经达到数量上限，和你GitHub证书仓库内是否存储Distribution证书无关——GitHub的match仓库仅用于同步存储你主动上传的证书文件，不会统计苹果开发者后台的实际证书数量。
• iOS证书并非仅能在单一环境使用：同类型证书导出p12格式后可以共享给多台Mac设备使用，只要对应私钥被正确导入设备钥匙串即可正常完成签名。fastlane match的机制默认按环境独立生成证书，只是为了避免多团队并行操作时出现冲突。

2. 作废旧的Development证书的方法 #

你可以通过两种方式操作：

• 批量作废所有Development证书：执行命令 fastlane match nuke development

注意：该命令会同时删除苹果开发者后台所有Development证书，以及GitHub match仓库中存储的所有Development类证书、描述文件，执行前请确认团队内没有成员正在使用旧的Development证书，否则会导致其他成员的签名操作失败。

• 单独作废指定Development证书：登录苹果开发者后台，进入「Certificates, Identifiers & Profiles」页面，找到对应要作废的Development证书，点击「Revoke」即可，操作完成后需要手动删除GitHub match仓库中存储的对应旧证书文件，避免后续match同步出现异常。

3. 仅存在1个Development证书仍提示达上限的解决方法 #

该问题通常由两类原因导致，对应解决方法如下：

• 本地钥匙串缓存异常/苹果后台存在隐藏占用名额的证书：先执行 fastlane match development --readonly 同步当前后台的有效证书到本地，再打开钥匙串访问工具，搜索「Apple Development」相关条目，删除所有过期、不受信任的证书后重新执行生成命令。
• match配置的账号信息不匹配：确认Fastfile或.env配置文件中的MATCH_USERNAME、TEAM_ID参数与你要操作的苹果开发者账号一致，确认无误后执行 fastlane match development --force 强制覆盖生成新证书即可。

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