React Native安卓闪退报getSourceURL空对象引用错误如何解决

核心原因 #

该报错为React Native桥接原生与JS的Catalyst实例未完成初始化/已被销毁时，调用了getSourceURL()方法触发的空指针异常，多和依赖版本不兼容、缓存残留、调试模式时序错误有关。 #

可按以下优先级尝试修复： #

1. 全量清理缓存并重新构建 #

关闭所有运行中的Metro服务、模拟器、调试工具，按顺序执行命令：
Windows环境执行：

# 进入项目根目录
rmdir /s /q node_modules
npm install
cd android
gradlew.bat clean
cd ..
npx react-native start --reset-cache
# 新开一个终端窗口执行
npx react-native run-android

2. 修复react-native-reanimated依赖兼容问题 #

你使用的react-native-reanimated@2.2.3和react-native@0.64.2存在已知的桥接初始化冲突：

• 首先检查项目根目录babel.config.js是否添加了reanimated插件，没有的话补全：

module.exports = {
  presets: ['module:metro-react-native-babel-preset'],
  plugins: ['react-native-reanimated/plugin'],
};

• 补全后仍报错，直接降级reanimated版本到适配的2.1.0：

npm install react-native-reanimated@2.1.0

修改完成后重新执行步骤1的清理构建流程。

3. 修正调试模式操作时序 #

该报错高频出现在远程调试提前开启的场景：

• 先卸载模拟器中已安装的当前应用
• 重新构建安装应用后，先等待首页完全加载完成，再按ctrl+M呼出开发者菜单开启远程调试
• 仍闪退的话在android/app/src/main/res/values/styles.xml中添加配置，修复启动页透明导致的初始化时序错误：

<item name="android:windowIsTranslucent">false</item>

4. 排查端口拦截问题 #

• 确认电脑和模拟器连接在同一局域网下
• 临时关闭Windows防火墙、第三方杀毒软件，避免8081端口被拦截
• 不要使用WSL2环境运行打包命令，直接在Windows PowerShell中执行相关操作，避免端口转发问题

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