React Native iOS编译报错：Undefined symbol: _RCTRegisterModule

1. 检查React Native核心库链接配置 #

• 打开Xcode，进入项目target设置，切换到Build Phases标签
• 找到Link Binary With Libraries，确认libReact-Core.a（RN 0.68版本对应库）已添加
• 若未添加，点击+按钮搜索并添加该核心库

2. 彻底清理缓存并重建项目 #

执行以下命令完成全链路缓存清理：

# 清理React Native项目缓存
npx react-native clean
# 清理iOS Pod依赖并重新安装
cd ios && pod deintegrate && pod cache clean --all && pod install
# 清理Xcode衍生数据
rm -rf ~/Library/Developer/Xcode/DerivedData

完成后重启Xcode，重新编译项目。

3. 调整Xcode架构编译设置 #

• 在target的Build Settings中，找到Architectures，设置为Standard Architectures (arm64, x86_64)
• 找到Build Active Architecture Only，Debug模式设为YES，Release模式保持NO
• 找到Excluded Architectures，Debug模式下添加arm64（适配M1芯片模拟器）

4. 校验第三方库版本兼容性 #

RN 0.68.1属于较旧版本，部分第三方库在Xcode 14.1下存在适配问题：

• 确认react_native_tracking_transparency、react_native_spinkit等库是否有适配RN 0.68的稳定版本，尝试降级到对应兼容版本
• 若找不到兼容版本，检查库的原生代码是否正确实现RCTRegisterModule注册逻辑，或是否遗漏React相关头文件引入

5. 调整编译系统与链接参数 #

• 打开Xcode，选择File > Project/Workspace Settings，将Build System设置为New Build System (Default)
• 在target的Build Settings中，找到Other Linker Flags，确保包含-ObjC和-lc++

6. 检查Podfile配置正确性 #

确认ios目录下的Podfile包含正确的React Native依赖引入逻辑：

require_relative '../node_modules/react-native/scripts/react_native_pods'
require_relative '../node_modules/@react-native-community/cli-platform-ios/native_modules'

platform :ios, '12.4'
install! 'cocoapods', :deterministic_uuids => false

target 'YourAppName' do
  config = use_native_modules!

  use_react_native!(
    :path => config[:reactNativePath],
    :hermes_enabled => false
  )

  # 其他项目配置...
end

修改后执行pod install重新安装依赖。

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