Xcode13.4.1编译React Native0.61项目Swift源文件失败报modulemap缺失

Xcode 13.4.1构建与react-native run-ios命令构建表现不一致、预编译桥接头阶段报modulemap缺失，本质是两套构建逻辑使用的架构参数、构建系统版本不统一：RN 0.61版本未适配Xcode 13+默认的arm64模拟器架构校验规则，Charts、RNCharts、SwiftyJSON等Swift依赖的模块搜索路径配置缺失，就会触发该类错误。

1. 统一架构配置，解决arm64模拟器编译冲突 #

Xcode 13+默认会为模拟器编译arm64架构，但RN 0.61的多数原生依赖未做对应适配，先统一全项目架构配置：

• 打开Xcode工程，选中主项目Target，进入Build Settings面板
• 找到Excluded Architectures配置项，在Debug（模拟器对应构建配置）下新增arm64；同时给Pods工程下所有第三方依赖Target配置相同规则，可直接在ios目录下的Podfile末尾添加如下脚本，之后执行pod install自动完成配置：

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'
      # 清空错误的全局modulemap配置
      config.build_settings['MODULEMAP_FILE'] = '' unless ['Charts', 'SwiftyJSON', 'RNCharts'].include? config.build_settings['PRODUCT_MODULE_NAME']
    end
  end
end

• 找到Build Active Architecture Only配置项，将Debug模式值设为Yes，Release模式可保留No

2. 修正Swift模块搜索路径与桥接头配置 #

直接删除桥接头路径的方案不适用于RN混编项目，按以下规则调整：

• 选中主Target，进入Build Settings > Swift Compiler - Search Paths
• 在Import Paths配置项中新增以下路径，全部勾选recursive（递归）选项：
  • $(SRCROOT)/Pods/Charts
  • $(SRCROOT)/Pods/SwiftyJSON
  • $(SRCROOT)/node_modules/react-native-charts-wrapper/ios
• 回到Objective-C Bridging Header配置项，确认路径为正确的项目相对路径，格式参考$(SRCROOT)/[你的项目名称]/App-Bridging-Header.h，不要留空。RN项目混编OC/Swift必须保留桥接头配置，直接删除会导致后续原生模块调用失败。

3. 清理全量缓存后重新验证 #

旧构建缓存会导致配置不生效，按顺序执行以下清理操作：

• Xcode内按下Cmd + Shift + K清理构建产物，再进入Xcode > Preferences > Locations，点击Derived Data路径旁的文件夹箭头，删除当前项目对应的缓存文件夹
• 终端进入项目根目录，执行以下命令重装依赖、清理JS缓存：

cd ios
rm -rf Pods Podfile.lock build
pod deintegrate
pod install
cd ..
npm start -- --reset-cache

• 先执行react-native run-ios --simulator="iPhone 11"验证构建：CLI启动后白屏是因为Metro服务未正常关联，不要关闭自动弹出的Metro终端窗口即可解决。CLI构建成功后，再回到Xcode直接执行构建，就不会再出现modulemap找不到的错误。

构建表现差异说明 #

react-native run-ios默认调用xcodebuild旧构建系统，会自动过滤不兼容的架构参数，因此不会触发预编译阶段的架构校验，但它不会自动同步最新的Metro服务配置，才会出现白屏；Xcode 13默认启用新构建系统，会严格校验全架构下的模块依赖完整性，因此会直接抛出modulemap缺失错误，二者的矛盾表现是构建配置不统一导致的，不属于项目代码逻辑问题。

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