Xcode选择fastlane match配置文件提示签名证书私钥缺失如何解决

触发的报错信息如下：

Missing private key for signing certificate.
Failed to locate the private key matching certificate "Apple Distribution: Xiaoqiang Jiang (6JP4P88ZJB)" in the keychain. To sign with this signing certificate, install its private key in your keychain. If you don't have the private key, select a different signing certificate for CODE_SIGN_IDENTITY in the build settings editor.

• 本地证书与match同步的证书不匹配：match会从你绑定的远端git仓库拉取预先存储的证书和描述文件，你本地自行导入的证书哪怕名称、团队ID完全一致，只要公钥哈希和match仓库中的证书不匹配，Xcode就无法匹配到对应私钥，本质是两个证书并非同一对公私钥生成的产物。
• 钥匙串权限不足：私钥被导入到系统钥匙串而非Xcode默认读取的登录钥匙串，或者私钥的访问控制列表未开放Xcode的读取权限，都会导致Xcode无法识别到已存在的私钥。
• Xcode 12.5.1版本缓存bug：该版本存在大量签名相关的缓存异常问题，旧的编译缓存、签名配置缓存未清理的情况下，会出现私钥已存在仍误报缺失的问题。
• 签名配置不匹配：Build Settings中CODE_SIGN_IDENTITY指定的证书类型，和match拉取的证书类型不对应（例如match配置的是企业级发布证书，项目配置选的是个人发布证书），也会触发匹配失败。

• 统一使用match同步的证书：拉取match绑定的git仓库最新内容，找到仓库内的证书文件双击安装，安装时选择存储到「登录」钥匙串，不要使用本地自行保存的其他证书文件，确保公钥和match拉取的证书完全一致。
• 调整私钥访问权限：打开钥匙串访问，找到对应发布证书，点击左侧展开箭头看到绑定的私钥，右键选择「显示简介」，切换到「访问控制」标签页，勾选「允许所有应用程序访问此项目」，或手动添加Xcode到允许访问的应用列表，保存设置后重启钥匙串访问。
• 清理Xcode缓存重置签名配置：
  1. 完全关闭Xcode，执行命令清理编译缓存：rm -rf ~/Library/Developer/Xcode/DerivedData
  2. 进入项目根目录执行清理命令：xcodebuild clean
  3. 重新打开Xcode，先在Signing & Capabilities页勾选「Automatically manage signing」等待系统自动同步配置完成后，再切回手动模式选择对应的match provision profile即可。
• 重置match证书（上述方案无效时使用）：执行命令match nuke distribution清空远端match仓库的旧证书与描述文件，再执行match distribution重新生成全套签名文件，安装新生成的证书到本地钥匙串即可解决匹配问题。

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