仅iOS 12.x版本下React Native TestFlight安装包崩溃求助

架构老林

2026-9-25

解决方案

根因说明

该问题是XCode 13构建TestFlight/App Store包时的特有兼容性问题：使用企业账号打企业包时不会触发苹果的Bitcode重编译流程，而提交到TestFlight的包会经过苹果服务器的Bitcode二次优化，XCode13默认的Bitcode配置、新链接器逻辑和iOS 12.x系统存在兼容性冲突，才会出现仅TestFlight包iOS12启动失败的情况。

可执行的修复步骤

关闭全局Bitcode选项
打开XCode项目，进入Targets > 应用主Target > Build Settings，搜索Enable Bitcode，将其设置为NO。如果有扩展Target（比如通知服务扩展、分享扩展等），需要同步把所有扩展的Bitcode也改为NO。修改后重新提交TestFlight构建，90%以上的同场景问题都可以通过该方案解决。
强制使用旧版链接器
如果项目必须开启Bitcode，就在Build Settings > Other Linker Flags中添加参数-ld64，强制使用XCode旧版链接器构建。XCode13默认启用的新链接器ld_prime对iOS12适配存在缺陷，切换链接器即可解决兼容性问题。
统一依赖库的最低系统版本
在项目的Podfile末尾添加如下配置，强制所有CocoaPods依赖的最低iOS版本为12.0，避免部分依赖默认高版本导致的加载失败：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.0'
    end
  end
end

修改后执行pod install重新安装依赖，再构建提交即可。

校验构建环境配置
优先使用本地XCode 13打TestFlight包测试，如果本地构建的包运行正常，说明是Microsoft App Center的构建配置存在差异，检查App Center的构建规则中是否开启了额外的TestFlight优化、Bitcode二次处理选项，关闭对应选项后重新构建即可。