Fastlane+GitHub Actions构建iOS报错：找不到匹配签名证书

核心问题分析 #

报错提示找不到匹配的分发证书，本质是Xcode无法从当前钥匙串中找到指定签名身份，大概率是钥匙串配置不当、证书导入权限不足、描述文件识别失败这几个原因导致。

具体解决步骤 #

1. 修复GitHub Actions中的钥匙串配置 #

当前创建了自定义钥匙串，但未将其加入Xcode的搜索列表，且缺少macOS钥匙串权限配置。修改证书导入步骤的run命令：

# Install certificate
- name: Install certificate
  env:
    IOS_CERTIFICATE_P12_FILE_CONTENT: ${{ secrets.IOS_CERTIFICATE_P12 }}
    IOS_CERTIFICATE_PASSWORD: ${{ secrets.IOS_CERTIFICATE_PASSWORD }}
  run: |
    mkdir -p ~/certificates
    
    echo "$IOS_CERTIFICATE_P12_FILE_CONTENT" | base64 --decode > ~/certificates/distribution.p12

    # 创建并配置钥匙串
    security create-keychain -p "xxxxx" /tmp/my.keychain
    security unlock-keychain -p "xxxxx" /tmp/my.keychain
    security set-keychain-settings -u -t 3600 /tmp/my.keychain  # 设置超时，避免构建中自动锁定
    security list-keychains -d user -s /tmp/my.keychain login.keychain-db  # 将自定义钥匙串加入搜索列表
    
    # 导入证书并设置权限
    security import ~/certificates/distribution.p12 -k /tmp/my.keychain -P "$IOS_CERTIFICATE_PASSWORD" -A
    security set-key-partition-list -S apple-tool:,apple: -s -k "xxxxx" /tmp/my.keychain  # 允许苹果工具访问证书
    
    # 验证证书是否导入成功
    security find-identity -v -p codesigning

关键修改点：

• 将自定义钥匙串添加到用户钥匙串搜索列表，确保Xcode能找到
• 设置钥匙串超时，避免构建过程中自动锁定
• 添加security set-key-partition-list命令，解决macOS钥匙串权限限制，让Xcode能正常访问证书

2. 修正描述文件的部署方式 #

Xcode通过UUID识别描述文件，直接复制原名可能无法被识别。修改描述文件配置步骤：

# Setting up provisioning profiles
- name: Set up provisioning profiles
  run: |
    mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles
    PROFILE_PATH="${{ github.workspace }}/ios/fastlane/provisioning/SQA_Profile.mobileprovision"
    # 提取描述文件的UUID
    PROFILE_UUID=$(grep -A 10 -B 5 UUID "$PROFILE_PATH" | grep -oE "[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}")
    # 按UUID重命名并复制，确保Xcode能识别
    cp "$PROFILE_PATH" "$HOME/Library/MobileDevice/Provisioning Profiles/$PROFILE_UUID.mobileprovision"

3. 优化Fastlane的build_app配置 #

确保签名身份与导入的证书完全匹配，或者让Fastlane自动匹配：

build_app(
  workspace: "Runner.xcworkspace",
  scheme: scheme_name,
  clean: true,
  export_method: "app-store",
  export_options: {
     provisioningProfiles: {
        app_bundle_identifier => provisioning_profile_name
     }
  },
  # 可选：如果手动指定，确保名称与security find-identity输出的完全一致
  # codesigning_identity: "Apple Distribution: COMPANY_NAME (XXXXX)"
  # 或者注释掉该行，让Fastlane自动匹配证书
)

4. 验证证书导出的完整性 #

确认本地导出的p12文件包含证书+私钥：

• 导出时在钥匙串中选择证书，确保其展开后能看到对应的私钥
• 导出过程中输入的密码与GitHub Secrets中的IOS_CERTIFICATE_PASSWORD完全一致
• 可以在本地尝试重新导入该p12文件，验证是否能正常使用

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