React Native未捕获异常无法被ErrorUtils捕获，Release APK显空白屏

一、React组件内异常无法触发全局ErrorHandler的原因 #

在React Native开发模式下，React框架会主动拦截组件渲染过程中抛出的异常，并显示红屏错误提示，这些异常不会被global.ErrorUtils的全局处理器捕获——这是React为开发阶段提供的调试机制，目的是让开发者快速定位组件问题。

解决方法： #

1. 开发阶段测试异常上报：
   如果需要在开发模式下验证上报逻辑，可以临时禁用React的错误捕获（不建议长期使用），或者直接在Release模式下测试（Release模式下React不会拦截异常，会抛到全局）。

2. 使用React Error Boundary捕获组件异常：
   React 16+推荐使用Error Boundary组件来捕获组件树内的异常，无论开发/Release模式都能生效。你可以封装一个全局的Error Boundary，在其中调用Crashlytics上报：

   import React from 'react';
   import { Crashlytics } from 'react-native-fabric';
   import StackTrace from 'stacktrace-js';
   
   class GlobalErrorBoundary extends React.Component {
     async componentDidCatch(error, errorInfo) {
       // 收集堆栈信息并上报
       const stackFrames = await StackTrace.fromError(error, { offline: true });
       const formattedStack = stackFrames.map(row => ({
         ...row,
         fileName: `${row.fileName}:${row.lineNumber || 0}:${row.columnNumber || 0}`
       }));
       
       Crashlytics.recordCustomExceptionName(
         error.message,
         error.message,
         formattedStack
       );
       
       console.log('Component error caught:', error);
     }
   
     render() {
       return this.props.children;
     }
   }
   
   // 在根组件中包裹所有内容
   // 例如：<GlobalErrorBoundary><App /></GlobalErrorBoundary>
   export default GlobalErrorBoundary;
   

二、Release模式下异常不崩溃反而显示空白的排查思路 #

你提到全新RN项目在Release模式下抛出异常会崩溃，但你的项目不会，说明某个第三方库修改了全局错误处理逻辑或React的异常行为。以下是高效排查方法：

1. 检查全局ErrorHandler是否被覆盖 #

你的自定义处理器可能被其他库替换了。在设置完global.ErrorUtils.setGlobalHandler(errorHandler)后，添加一段代码验证：

setTimeout(() => {
  console.log('Current global error handler:', global.ErrorUtils.getGlobalHandler());
}, 1000);

如果打印的不是你的errorHandler函数，说明有其他库调用了ErrorUtils.setGlobalHandler覆盖了你的设置。

2. 搜索第三方库中的全局错误处理代码 #

在项目根目录执行以下命令，查找哪些库在修改全局错误处理：

# 查找修改ErrorUtils的代码
grep -r "ErrorUtils.setGlobalHandler" node_modules/

# 查找监听全局error/unhandledRejection事件的代码
grep -r "window.addEventListener('error'" node_modules/
grep -r "process.on('unhandledRejection'" node_modules/

重点关注输出结果中的库，比如调试工具（如Reactotron）、状态管理库（如redux-persist、redux-saga）或第三方UI库。

3. 逐步移除可疑库定位根因 #

不用从零开始逐个添加库，而是从你的依赖中移除差异较大的库（即全新RN项目没有的库），每次移除后打包Release版本测试：

• 优先排查：redux-persist-sensitive-storage、react-native-sensitive-info（涉及存储的库可能吞掉异常）、react-navigation-redux-helpers（导航相关的状态管理可能拦截错误）
• 其次排查：react-native-fabric本身（虽然你用它上报，但也可能有异常拦截逻辑）、axios（网络请求库是否有全局错误捕获）

4. 验证Release包的依赖打包情况 #

确保Release模式下没有打包dev依赖（如Reactotron、enzyme等）。检查package.json的scripts中的打包命令，确认是否正确使用了--variant=release，且babel配置没有包含dev环境的代码。

总结 #

• 组件内异常：用Error Boundary补充全局ErrorUtils，覆盖React的组件异常拦截逻辑；
• Release模式异常不崩溃：通过搜索全局错误处理代码、逐步移除可疑库快速定位第三方库的问题。

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