React Native 0.79（新架构+Hermes）iOS端运行时崩溃：RNMapsAirModule未找到

嘿，我来帮你搞定这个头疼的问题！你遇到的是react-native-maps在新架构下的TurboModule注册异常，尤其是iOS端找不到RNMapsAirModule的情况，我整理了几个针对性的解决步骤，你挨个试试：

• 先确认react-native-maps版本适配性
  首先得确保你用的react-native-maps版本支持RN0.79的新架构，建议直接升级到最新稳定版（比如1.10.x及以上），旧版本大概率没适配TurboModule体系，这是最常见的诱因。

• 彻底清理并重建iOS依赖
  缓存残留很容易搞出这种问题，按顺序执行以下命令：

  cd ios
  pod deintegrate
  rm -rf Podfile.lock build
  pod install --use-frameworks --enable-dynamic-frameworks
  

  别忘啦，执行完后去Xcode里点击Product -> Clean Build Folder清理构建缓存，再重新编译项目。

• 检查TurboModule的注册配置
  新架构下TurboModule需要手动注册（部分库会自动处理，但偶尔会出问题）：

  1. 打开iOS项目的AppDelegate.mm文件，确认顶部是否引入了对应的头文件：

     #import <RNMapsAirModuleSpec/RNMapsAirModuleSpec.h>
     

  2. 在application:didFinishLaunchingWithOptions:方法的TurboModule注册代码块里，添加模块类：

     modulesProvider = [[RCTTurboModuleRegistryProvider alloc] initWithModuleClasses:@[
         RNMapsAirModule.class,
         // 其他已有的模块保持不变
     ]];
     

  另外还要检查Xcode项目中是否包含RNMapsAirModule.mm这类文件，如果缺失，可能需要重新安装react-native-maps或者手动把这些文件添加到项目中。

• 验证Hermes和新架构的配置

  1. 打开Xcode的Build Settings，搜索ENABLE_HERMES，确认它的值是YES；
  2. 检查Podfile里的新架构配置是否正确：

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

• 排查metro配置冲突
  打开metro.config.js，确保resolver部分没有排除react-native-maps相关的模块，比如不要在blacklistRE或者blockList里过滤掉RNMapsAirModule的文件。

如果以上步骤都试过还是不行，建议你新建一个干净的RN0.79项目，只安装react-native-maps并配置新架构，看看能不能正常运行——这样可以快速排查是不是项目里其他依赖导致的冲突问题。

备注：内容来源于stack exchange，提问作者추성우