升级Xcode 14后React Native iOS构建失败：arm64架构符号缺失

问题背景 #

自2023年4月Apple要求所有iOS应用必须使用Xcode 14构建后，项目在本地及GitHub CI环境升级Xcode后均构建失败。使用fastlane、Xcode手动构建、xcodebuild命令执行构建时，均在链接阶段报错：

ld: symbol(s) not found for architecture arm64

Dev配置下模拟器可正常构建，但Release配置（目标为generic/platform=iOS）构建失败，同步Dev与Release配置也无效果。

已尝试方案 #

• 清理并重新集成Pods
• 更新CocoaPods至最新版本
• 打开Workspace而非Project文件进行构建
• 切换“Build Active Architecture Only”开关状态
• 为“Any iOS Simulator SDK”排除arm64架构
• 调整项目及Pods的库搜索路径（Library Search Paths）
• 在Rosetta终端及x86_64 GitHub Runner环境中构建
• 关闭项目及Pods的Bitcode选项

后续排查方向 #

1. 验证第三方库的架构兼容性 #

• 用lipo -info [库文件路径]命令检查所有依赖的第三方库（尤其是闭源静态库/Framework），确认其包含arm64架构的Release版本。部分老旧库可能未适配Xcode 14的编译规则，需更换为适配版本或联系库提供者更新。
• 若使用开源库，查看其Issue列表是否有Xcode 14适配相关问题，尝试切换至最新稳定分支测试。

2. 逐行对比Dev与Release的Build Settings差异 #

不要依赖配置同步工具，手动核对以下关键项：

• Architectures与Valid Architectures：确保Release配置包含arm64，无多余架构过滤规则
• Other Linker Flags：检查Release是否遗漏或多添加了必要的链接标记（如-ObjC、-all_load）
• Dead Code Stripping：Release默认开启，若符号被误判为无用代码剥离，可临时关闭该选项测试
• Optimization Level：将Release的优化等级临时改为None [-O0]，排查是否因代码优化导致符号丢失

3. 检查Pod依赖的配置特殊性 #

• 查看Podfile中的post_install脚本，确认是否针对Release配置修改了某个库的Build Settings，导致编译规则异常。
• 执行pod deintegrate后重新pod install，检查Pods/Target Support Files下对应库的Release配置文件，确认无异常的架构或链接设置。

4. 分析链接阶段的详细日志 #

• 执行xcodebuild时添加-verbose参数，获取完整链接命令及日志，定位具体缺失的符号所属库：

  xcodebuild -workspace YourProject.xcworkspace -scheme YourScheme -configuration Release -sdk iphoneos build -verbose
  

• 根据日志中的缺失符号，检查对应的类/方法是否因#ifdef DEBUG等宏定义，仅在Dev环境下编译。

5. 排查CI环境的缓存与参数问题 #

• 在GitHub CI脚本中添加清理步骤：删除DerivedData、Pods目录、缓存的构建产物，避免旧文件干扰。
• 确认CI中使用的Xcode版本与本地一致，且xcodebuild命令指定的SDK、配置参数正确（未误指定Simulator SDK而非iOS SDK）。

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