Fastlane gym多target构建无法找到provisioning profile如何排查

核心问题定位 #

编译阶段提示找不到provisioning profile的报错，本质原因是当前配置仅在ipa导出阶段指定了签名规则，xcodebuild编译阶段没有拿到每个target对应的provisioning profile配置。update_code_signing_settings只完成了关闭自动签名的操作，没有给编译阶段绑定对应profile，因此还没走到导出流程就直接报错。

分步排查与修复 #

1. 先确认本地provisioning profile安装有效 #

• 打开Finder按Cmd+Shift+G，进入~/Library/MobileDevice/Provisioning Profiles/目录，确认match拉取的所有profile都存在，文件无损坏、权限正常，逐个双击profile确认系统可正常识别。
• 执行命令security cms -D -i <profile文件全路径>解包每个profile，核对内部的Bundle ID、Team ID、entitlements（能力配置）和Xcode中对应target的Signing & Capabilities配置完全匹配，重点检查Widget的App Groups、主target的Associated Domains/Push等能力，缺项或不匹配都会直接报错。

2. 补全Fastfile中编译阶段的签名配置（90%概率修复问题） #

当前gym配置缺少两个核心参数，导致xcodebuild编译阶段无法匹配到正确的profile，按如下方式修改gymOptions：

gymOptions = ({
  silent: true,
  export_team_id: ENV['IOS_TEAM_ID'],
  # 新增：明确指定AdHoc分发使用的签名证书，替换成你实际的证书名称
  codesigning_identity: "Apple Distribution: 你的公司主体名 (#{ENV['IOS_TEAM_ID']})",
  export_options: {
    signingStyle: "manual",
    provisioningProfiles: { 
      ENV['IOS_APP_ID'] => "match AdHoc #{ENV['IOS_APP_ID']}",                                                   
      ENV['SIRI_BUNDLE_ID'] => "match AdHoc #{ENV['SIRI_BUNDLE_ID']}",
      ENV['PUSH_INTERCEPTOR_BUNDLE_ID'] => "match AdHoc #{ENV['PUSH_INTERCEPTOR_BUNDLE_ID']}",
      ENV['WIDGETS_BUNDLE_ID'] => "match AdHoc #{ENV['WIDGETS_BUNDLE_ID']}"
    }
  },
  # 新增：给编译阶段透传每个target的provisioning profile配置
  xcargs: {
    "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" => "",
    "PROVISIONING_PROFILE_SPECIFIER[config=Release]" => ""
  }.merge(
    ios_target_names.map { |target|
      target_bundle_id = case target
      when "app" then ENV['IOS_APP_ID']
      when "SiriAction" then ENV['SIRI_BUNDLE_ID']
      when "PushInterceptor" then ENV['PUSH_INTERCEPTOR_BUNDLE_ID']
      when "WidgetsExtension" then ENV['WIDGETS_BUNDLE_ID']
      end
      {"PROVISIONING_PROFILE_SPECIFIER[target='#{target}']" => "match AdHoc #{target_bundle_id}"}
    }.reduce(:merge)
  )
}).merge(
  File.directory?("../#{xcworkspace}") ?
    {workspace: xcworkspace} :
    {project: xcodeproj}
)

注意：Xcode 13及以上版本已经废弃通过UUID指定profile的PROVISIONING_PROFILE参数，必须使用PROVISIONING_PROFILE_SPECIFIER按profile名称指定，否则会出现识别失败问题。

3. 清理缓存避免旧配置干扰 #

在match和gym执行前，新增两步清理操作，避免本地旧签名、编译缓存影响结果：

# 清理Xcode编译缓存
clear_derived_data
# 清理本地失效的旧provisioning profile
clean_profiles(path: "~/Library/MobileDevice/Provisioning Profiles")

如果不使用fastlane内置action，也可以手动执行：

• 删除~/Library/Developer/Xcode/DerivedData/目录下所有内容
• 打开Xcode设置->Accounts->选中对应团队->Manage Certificates，清理重复的失效旧证书

4. 仍报错时的日志定位方法 #

临时把gym的silent: true改为false，加上log_xcodebuild_output: true参数重新构建，在输出日志中搜索PROVISIONING_PROFILE_SPECIFIER，核对每个target实际读取到的profile名称是否和配置一致：

• 打开Xcode项目，选中每个target的Build Settings，搜索provisioning profile，确认Release配置下没有硬编码写死旧的profile UUID/名称，所有配置项都设为$(inherited)，保证fastlane传入的参数能被正常继承。
• 检查Podfile的post_install钩子，很多CocoaPods脚本会重置extension target的签名配置，导致fastlane传入的参数不生效，如果存在这类逻辑，需要在post_install块中同步给所有target设置手动签名规则。

常见避坑点 #

• 核对所有target的Bundle ID和ENV变量中的值完全一致，注意target名和Bundle ID的映射关系不要写错，比如日志中报错的WidgetsExtension，要确认它的Bundle ID和ENV['WIDGETS_BUNDLE_ID']完全匹配。
• 执行完update_code_signing_settings后，可以用get_build_configuration action读取每个target的CODE_SIGN_STYLE值，确认是Manual而非Automatic，避免自动签名逻辑覆盖手动配置。

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