React Native 0.68.0不同设备Xcode运行结果差异问题排查

问题复现特征 #

• 测试设备与同事设备仅处理器存在差异，其余软硬件配置基本一致
• 双方均新建React Native 0.68.0版本项目测试，同事可正常运行，本机通过Xcode启动时报错
• 已尝试操作：重启电脑、更新pods依赖、删除Podfile.lock后重新安装pods，均未解决问题
• 版本规律：React Native 低于0.68版本的新建项目可正常运行，故障仅在版本≥0.68.0时出现

核心故障原因 #

React Native 从0.68版本开始默认启用新架构（包含Fabric渲染器、TurboModules模块体系），编译环节对处理器架构的校验规则比旧版本严格很多，结合你和同事仅处理器有差异的前提，故障基本锁定为Intel x86_64 与 Apple Silicon（M系列arm64）的架构适配问题，常见触发场景如下：

• 本机安装的CocoaPods、Node.js等基础依赖是通过Rosetta转译运行，和系统原生架构不匹配，0.68+版本新架构编译时会拉取到错误架构的二进制依赖，直接触发报错
• Xcode构建设置中Build Active Architecture Only配置项在Debug模式下被误设为NO，触发非当前设备架构的无效编译
• 项目Pod配置未自动对齐当前处理器架构，0.68之前的旧架构对多架构兼容容忍度高，哪怕配置有偏差也能正常运行，新架构开启后执行严格校验直接中断编译

可直接落地的修复步骤 #

1. 校正终端运行架构
   打开终端执行arch命令，Apple Silicon设备如果输出i386/x86_64说明当前是Rosetta转译模式，右键终端应用点击「显示简介」，取消勾选「使用Rosetta打开」，重启终端后重装适配原生架构的基础依赖：

   # 卸载原有架构不匹配的CocoaPods
   sudo gem uninstall cocoapods
   # 通过brew安装适配当前系统架构的CocoaPods
   brew install cocoapods
   # 进入项目ios目录全量清理重装依赖
   cd ios
   pod deintegrate
   pod cache clean --all
   rm -rf Pods Podfile.lock build
   pod install
   

2. 校正Xcode编译配置
   打开项目的.xcworkspace文件，选中项目target进入Build Settings页，搜索Build Active Architecture Only，确认Debug模式下的值为YES即可，Release模式可按需配置。
3. 新架构开关校验
   如果上述操作完成后仍报错，可以先修改ios目录下Podfile文件，将新架构开关暂时设为关闭：:fabric_enabled => false, :turbomodule_enabled => false，重新执行pod install后启动项目，验证是否为新架构编译链路的适配问题。

补充说明：如果是Intel处理器设备运行M系列芯片同事同步过来的项目，注意检查项目配置中是否存在手动写死排除arm64架构的硬编码项，0.68+新架构下这类配置会直接触发编译报错，删除对应配置项即可。

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