React Native iOS运行报错Native module cannot be null无堆栈如何调试？

1 先补全缺失的堆栈上下文 #

• 不用react-native run-ios启动，改用Xcode打开ios目录下的xcworkspace文件运行项目，在Xcode左侧「Debug Navigator」面板可以查看完整的Native侧崩溃调用栈
• 在项目入口JS文件（通常为index.js或App.tsx）顶部添加全局错误捕获逻辑，打印完整JS堆栈：

// 仅开发环境生效
if (__DEV__) {
  const originalHandler = global.ErrorUtils.getGlobalHandler();
  global.ErrorUtils.setGlobalHandler((error, isFatal) => {
    console.error('全局捕获错误详情：', error.message);
    console.error('错误堆栈：', error.stack);
    originalHandler(error, isFatal);
  });
}

• 启动应用后打开Chrome调试器的Console面板，重新触发报错即可拿到完整的JS调用栈，直接定位到调用异常Native模块的代码位置

2 按优先级排查根因 #

你已经试过的清理依赖、重建Pods、手动link操作无效的情况下，按以下顺序排查：

• 优先回滚最近的改动：如果报错是在新增/升级依赖、修改Podfile、升级RN版本之后出现的，直接回滚这部分改动验证，90%以上的该类错误都是新增依赖的Native模块没有正确集成导致
• 校验Autolinking配置：RN 0.60及以上版本默认支持Autolinking，手动执行react-native link反而会导致重复集成冲突，打开Xcode项目配置的「Build Phases - Link Binary With Libraries」栏，删除重复引入的Native库，再重新执行cd ios && pod install --repo-update即可
• 逐个校验Native模块引用：全局搜索项目中所有NativeModules.xxx的调用，依次注释验证，定位到引用了不存在的Native模块的代码位置

3 兜底定位方案 #

如果上述方法都无法定位，新建一个同版本的空白RN项目，将你的业务代码和依赖逐个迁移到新项目中，每迁移一部分就运行一次iOS构建，很快就能定位到引发问题的代码或依赖。

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