GitLab CI+Fastlane构建iOS项目时签名证书缺失问题求助

本地构建正常但CI环境报错签名证书找不到，核心原因是CI环境是全新的干净环境，没有本地钥匙串里的iOS签名证书和对应私钥，自动签名机制在CI里没法像本地一样自动获取或创建签名资产。下面是具体解决步骤：

方案1：用fastlane match统一管理签名资产（推荐） #

fastlane match可以把证书、私钥和Provisioning Profile存在私有Git仓库，CI环境只需拉取就能复用，避免手动配置的麻烦：

1. 本地初始化match：

   bundle exec fastlane match init
   

   按提示选择存储仓库（比如GitLab私有库），输入Apple ID和Team ID。

2. 在你的build lane里添加match调用，调整原有配置：

   lane :build do
     # 先拉取签名资产，Release环境用appstore类型，Debug用development
     match(type: "appstore", readonly: true)
     build_app(
       scheme: "XXXXXXXXXXXXX", 
       clean: true,
       silent: true,
       skip_package_dependencies_resolution: true,
       output_directory: "./build", 
       output_name: "XXXXXXXXXXXXXXXX.ipa", 
       configuration: "Release",
       export_team_id: "XXXXXXXXXX" # 打开这个配置，明确指定你的Team ID
     )
   end
   

3. CI脚本里确保Git能访问match的仓库，可通过GitLab CI变量存储SSH密钥或个人访问令牌，实现拉取仓库时自动认证。

方案2：手动导入证书到CI环境 #

如果不想用match，可手动把证书和私钥导入CI的钥匙串：

1. 本地导出iOS签名证书和私钥为p12文件，设置导出密码。
2. 把p12文件转成base64后，上传到GitLab项目的CI/CD变量（比如命名为IOS_CERTIFICATE_P12），同时把导出密码设为IOS_CERTIFICATE_PASSWORD变量。
3. 修改GitLab CI脚本，添加导入钥匙串的步骤：

   stage: build
     script:
       - cd $HOME/workspace/iOS/attijarimobile-ios/
       # 创建临时钥匙串并配置权限
       - security create-keychain -p tempPassword build.keychain
       - security default-keychain -s build.keychain
       - security unlock-keychain -p tempPassword build.keychain
       - security set-keychain-settings -t 3600 -u build.keychain
       # 导入证书到钥匙串
       - echo "$IOS_CERTIFICATE_P12" | base64 --decode > certificate.p12
       - security import certificate.p12 -k build.keychain -P "$IOS_CERTIFICATE_PASSWORD" -T /usr/bin/codesign
       # 执行fastlane构建
       - bundle exec fastlane ios build
       # 清理临时钥匙串（可选）
       - security delete-keychain build.keychain
   

额外检查项 #

• 确认CI环境的Xcode版本和本地完全一致，不同Xcode版本的签名逻辑可能存在差异。
• 检查项目的Xcode配置：确保Target的Signing & Capabilities里，Release配置的"Automatically manage signing"处于开启状态，和fastlane的use_automatic_signing: true配置对应。

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