Expo eject引入Native Module库遇未注册模块报错与白屏问题

循环抛出的Module RCTLog is not a registered callable module、Module AppRegistry is not a registered callable module、Module RCTDeviceEventEmitter is not a registered callable module 都是衍生报错，不是问题根源。这类报错的唯一触发场景是：RN原生运行时在JS bundle完成初始化加载之前，就因为原生层的加载冲突、符号错误、版本不匹配直接中断了桥接流程，导致JS侧根本没机会完成核心内置模块的注册，自然会循环提示找不到这些基础模块。
已经验证的事实是：只要去掉自定义库的import语句应用就正常，这个问题的排查范围可以完全锁定在自定义原生库的加载链路上。之前尝试的清Metro缓存、删node_modules重装、重新装Pod这些常规操作，根本碰不到原生层的冲突点，所以不会产生效果。

• 第一优先级：排查双RN实例的版本冲突
  用官方脚手架生成自定义库的时候，默认会根据生成库当时的环境，在库的package.json里写入对应RN、React版本的peerDependency。如果这个peerDependency的版本和当前正式项目的版本（react 16.13.1、react-native 0.63.4）不一致，npm安装的时候会在自定义库的目录下自动生成一份独立的node_modules，拉取独立的RN实例。
  这种场景下会出现两个RN的原生桥接实例同时链接进应用，两边的模块注册逻辑互相冲突，直接打断JS运行时的初始化流程，和当前的白屏症状完全匹配。
  验证和解决操作：
  • 安装完依赖后检查文件路径，确认整个项目里只有主项目根目录下存在一份node_modules/react-native，如果在自定义库的目录下发现独立的node_modules/react-native，直接删除该目录。
  • 打开自定义库的package.json，把peerDependency里的react、react-native版本完全对齐主项目的版本号，重新执行依赖安装。
• 第二优先级：排查Expo工程的原生加载顺序冲突
  项目基于Expo开发，哪怕后续执行eject操作，Expo的RN运行时是做过定制封装的，原生模块的加载顺序和纯CLI生成的原生工程完全不同。纯CLI脚手架生成的自定义库，默认会在CocoaPods链接流程里被放在依赖列表的靠前位置，如果自定义库的加载顺序早于Expo核心框架、RN核心桥接模块，就会出现桥接实例还没初始化完成，自定义库就已经尝试访问RN的模块注册方法，直接触发运行时崩溃，此时JS侧根本没启动，就会出现白屏。
  解决操作：
  • 打开iOS目录下的Podfile，确认自定义库对应的pod引用位置在React-Core、Expo核心依赖的pod声明之后，不要把自定义库的pod写在依赖列表的最开头。
  • 本地自定义库不要直接通过相对路径硬编码写在Podfile里，要依赖RN0.63版本的自动链接机制完成pod注册，保证链接顺序符合原生运行时的初始化要求。
• 第三优先级：排查BROTHER SDK的符号冲突
  集成的BROTHER官方移动SDK属于第三方闭源原生SDK，很多这类SDK会静态链接内置的基础工具库，甚至部分低版本SDK会内置旧版RN的桥接代码。如果SDK内置的类名、符号和主项目的RN核心模块重名，编译的时候哪怕没有报错，链接阶段也会出现符号被覆盖的问题，直接打断RN桥接的初始化流程。
  解决操作：
  • 打开Xcode的编译日志，检查所有重复符号的警告，确认有没有SDK相关的类和RN核心模块重名。
  • 打开Xcode的EXC_BAD_ACCESS断点，Debug模式启动应用，查看第一次崩溃的栈帧位置，确认是否卡在SDK初始化的阶段，导致RN桥接被强制终止。
• 第四优先级：对齐Expo和RN的版本兼容
  当前使用的react-native 0.63.4、react 16.13.1对应的是Expo SDK 40版本。如果后续eject的时候使用的Expo CLI版本过高，生成的原生工程会自动升级Expo的核心原生依赖，和自定义库里的原生API调用逻辑不兼容，也会出现桥接初始化失败的问题。eject操作需要严格匹配SDK 40对应的CLI版本，不要使用最新版CLI生成原生工程。

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