Fastlane Match与GitHub Actions无法访问证书仓库的问题

• 技术栈：React Native项目，集成Fastlane + GitHub Actions
• 本地操作流程：
  1. 进入ios目录，执行fastlane init、fastlane match init
  2. 添加GitHub证书仓库地址（HTTPS格式）
  3. 执行fastlane match development，成功完成证书安装
• 异常情况：GitHub Actions运行时触发权限错误，无法访问证书仓库
• 已完成配置：
  • 按文档要求配置Fastfile、Matchfile、GitHub Workflow片段
  • 生成MATCH_GIT_BASIC_AUTHORIZATION（用户名+个人访问令牌的Base64编码），并存储为仓库Actions密钥
  • 本地通过SSH可正常克隆证书仓库，但HTTPS方式克隆失败；修改仓库地址后认证问题未解决
  • Xcode已关闭自动管理签名，项目使用.xcworkspace，App ID已在App Store Connect创建

1. 校验MATCH_GIT_BASIC_AUTHORIZATION有效性 #

• 确认编码源为你的GitHub用户名:个人访问令牌(PAT)，PAT需具备证书仓库的读写权限（至少开启repo权限）
• 本地解码验证：用echo "编码值" | base64 --decode检查是否与原字符串完全一致，避免编码时引入多余空格或换行

2. 切换证书仓库访问协议 #

如果HTTPS认证始终失败，改用SSH方式访问：

• 在证书仓库的Settings > Deploy keys中添加GitHub Actions的SSH公钥（或在仓库Actions密钥中配置SSH_PRIVATE_KEY）
• 修改Matchfile中的仓库地址为SSH格式：git@github.com:你的用户名/证书仓库名.git
• 在GitHub Workflow中添加SSH密钥加载步骤：

  - name: Setup SSH Agent
    uses: webfactory/ssh-agent@v0.7.0
    with:
      ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}
  

3. 确保Workflow环境变量传递正确 #

• 在Workflow中明确传递MATCH_GIT_BASIC_AUTHORIZATION密钥：

  jobs:
    build:
      runs-on: macos-latest
      env:
        MATCH_GIT_BASIC_AUTHORIZATION: ${{ secrets.MATCH_GIT_BASIC_AUTHORIZATION }}
      steps:
        # 其他步骤（checkout、安装依赖等）
        - name: Run Fastlane Match
          run: cd ios && fastlane match development --readonly
  

• 可临时添加echo $MATCH_GIT_BASIC_AUTHORIZATION步骤（调试后删除），验证变量是否正确加载

4. 检查Fastlane Match配置细节 #

• Matchfile中确认app_identifier与App Store Connect中的App ID完全一致，type设置为development
• 本地执行fastlane match development --verbose，对比Actions中的日志，定位认证环节的差异
• 若存在缓存问题，可在Actions中执行fastlane match nuke development（谨慎操作，会删除现有证书）后重新生成

5. 验证GitHub Runner权限 #

• GitHub-hosted runner：确认密钥已添加到仓库的Settings > Secrets and variables > Actions中，且权限为仓库可见
• self-hosted runner：检查runner网络是否能正常访问GitHub，以及runner用户是否具备读取密钥的权限

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