iOS开发：Xcode手动签名时Provisioning Profile证书错误求助

问题背景 #

我正在开发一款iOS应用，已在网页版Apple Developer控制台完成以下操作：

• 创建应用及对应的App ID与Bundle ID
• 创建CSR并以此生成Certificate
• 创建关联该Certificate的Provisioning Profile并下载

随后在Xcode的Signing & Capabilities标签页导入该Provisioning Profile时出现意外错误（截图：Provisioning Profile导入错误）。我希望使用手动签名而非自动签名，请问为何会出现此警告/错误？如何解决以实现构建/签名/归档，并手动上传归档至Test Flight供少量测试人员体验？

更新补充问题 #

按照建议操作后，在Xcode中打开下载的Profile时出现错误（截图：打开Profile错误）。奇怪的是，我在Apple Developer控制台的所有Certificate中，均未找到名为"Apple Distribution: Holdings LLC"的证书，不清楚Xcode为何认为该证书应嵌入到Profile中。

错误原因分析 #

初始导入错误可能原因 #

1. 证书私钥缺失：你在开发者后台生成的Certificate，对应的私钥不在当前电脑的Keychain中——如果CSR是在其他电脑生成的，当前电脑没有导入配对的私钥，Xcode无法验证Profile的合法性。
2. Bundle ID不匹配：Profile绑定的App ID与Xcode项目中设置的Bundle ID不一致，Xcode会拒绝识别该Profile。
3. Profile类型错误：上传TestFlight需要使用Distribution类型的Profile，若误选了Development类型，会与发布签名需求冲突。

更新后错误的核心原因 #

Xcode提示的"Apple Distribution: Holdings LLC"证书，说明你下载的Profile在后台创建时实际关联了该证书，可能的情况：

• 团队其他成员创建了该证书并绑定到Profile，你无权限查看或下载；
• 创建Profile时误选了该证书，而非你自己生成的那个；
• Xcode缓存了旧的证书/Profile信息，导致识别混乱。

分步解决方案 #

一、解决Profile导入/打开错误 #

1. 清理本地缓存

   • 关闭Xcode，打开~/Library/MobileDevice/Provisioning Profiles文件夹，删除所有Profile文件；
   • 打开Keychain Access，删除过期或无关的iOS开发/发布证书；
   • 重启Xcode后重新导入你的Profile。

2. 验证并修正Profile的证书绑定

   • 回到Apple Developer控制台，打开你创建的Profile详情页，查看Certificates绑定列表：
     • 如果列表中有"Apple Distribution: Holdings LLC"，点击Edit，重新选择你自己生成的Certificate，保存后重新下载Profile；
     • 如果列表中只有你的证书，执行以下命令强制刷新Xcode缓存：

       xcrun simctl delete all
       xcrun xcodecleanup
       

3. 确保本地有完整证书+私钥对

   • 若CSR在其他电脑生成，需从该电脑导出私钥为.p12文件，导入到当前电脑的Keychain；
   • 确认Keychain中同时存在你的Certificate和对应的私钥（私钥会显示在证书的下拉列表中）。

二、配置手动签名并归档上传TestFlight #

1. Xcode手动签名配置

   • 在Signing & Capabilities标签页，勾选Manual signing；
   • 在Provisioning Profile下拉框选择你导入的正确Profile（未显示则点击Import Profile重新导入）；
   • 确认Bundle Identifier与Profile绑定的App ID完全一致；
   • 确认Signing Certificate选择你的Distribution证书。

2. 归档与上传

   • 点击菜单栏Product > Archive，等待构建完成；
   • 在Organizer窗口选中归档，点击Distribute App；
   • 选择App Store Connect → TestFlight，按向导完成上传。

3. TestFlight测试人员配置

   • 登录App Store Connect，进入应用的TestFlight标签页；
   • 在Internal Testing或External Testing中添加测试人员的Apple ID，发送邀请即可。

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