React Native iOS模拟器构建失败求助（x86_64符号缺失）

核心问题定位 #

你遇到的问题是M1 Mac环境下，iOS模拟器构建时的架构不匹配（x86_64与arm64冲突），以及MLKit相关依赖库的符号链接失败，两者叠加导致链接器退出。

1. 调整Xcode项目架构设置 #

• 打开iOS目录下的.xcworkspace文件
• 选中项目根目标（MyApp），进入Build Settings
  • 搜索Excluded Architectures，在Debug和Release的Any iOS Simulator SDK中添加arm64
  • 搜索Build Active Architecture Only，设置为Yes（仅Debug模式）

2. 修改Podfile配置 #

在ios/Podfile中添加以下配置，强制模拟器使用x86_64架构：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      # 排除模拟器的arm64架构
      config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"
      # 锁定React Native相关库的模拟器架构为x86_64
      if target.name.start_with?("React")
        config.build_settings["ARCHS[sdk=iphonesimulator*]"] = "x86_64"
      end
    end
  end
end

3. 彻底清理并重新构建 #

执行以下命令清理所有缓存和依赖：

# 清理Node依赖
rm -rf node_modules && npm install

# 进入iOS目录清理Pods
cd ios
rm -rf Pods Podfile.lock
pod deintegrate
pod install --repo-update

# 清理Xcode衍生数据
rm -rf ~/Library/Developer/Xcode/DerivedData

4. 用Rosetta运行终端（M1/M2专属） #

• 找到终端应用，右键选择显示简介，勾选使用Rosetta打开
• 关闭现有终端，重新打开后执行：

  npx react-native run-ios
  

5. 修复MLKit依赖符号问题 #

如果以上步骤仍未解决，检查MLKit相关依赖：

• 查看package.json中的MLKit类库（如react-native-firebase/mlkit），调整版本至与React Native 0.70.6兼容的版本
• 执行pod install后，确认Pods目录下存在MLKitCommon、MLKitVision及它们的依赖库（如GTM、GUL系列）

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