React Native项目生成安卓APK安装后启动白屏闪退如何解决？

打包配置类问题 #

• 签名配置错误：Release包签名配置缺失/不匹配，部分安卓系统会拦截未正确签名的应用，启动验证失败直接闪退，可检查项目android/app/build.gradle中的signingConfigs配置，确认是否和打包用的签名文件信息一致
• 混淆规则缺失：开启代码压缩minifyEnabled=true后，未添加React Native官方要求的混淆规则，导致运行时核心类被裁剪找不到触发闪退
• 架构适配缺失：打包时只生成了部分ABI架构的包，安装到不匹配架构的设备上时so库加载失败，可检查build.gradle中ndk.abiFilters配置是否覆盖了目标设备的常用架构（armeabi-v7a、arm64-v8a是当前主流适配项）

资源加载类问题 #

• JS bundle打包缺失：Release包构建时未正确生成JS bundle文件，或bundle存放路径配置错误，应用启动阶段加载不到JS代码导致白屏后闪退，可手动执行打包命令验证：

react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res

执行后检查对应路径下是否生成了bundle文件，再执行安卓打包命令

• 静态资源引用错误：代码中引用的图片、字体等静态资源路径有误，打包时资源未被正确打入APK，启动阶段加载资源失败触发闪退
• 启动屏配置异常：启动屏资源不存在、尺寸适配错误，或启动屏逻辑和JS入口逻辑冲突，也会导致启动阶段白屏后闪退

系统适配类问题 #

• 必要权限未声明：应用启动阶段就需要调用存储、网络等底层能力，但AndroidManifest.xml中未提前声明对应权限，初始化失败触发闪退
• 系统版本不兼容：代码或依赖的原生库使用了高于目标设备安卓版本的API，或是RN版本和安卓编译SDK版本不匹配，可核对build.gradle中compileSdkVersion、targetSdkVersion和目标设备安卓版本的适配性
• 第三方原生库适配错误：引入的第三方原生库未做安卓架构/版本适配，或是原生层初始化逻辑写在应用启动阶段，初始化失败直接触发闪退，可优先排查近期新增的原生依赖是否存在适配问题

运行时代码异常 #

• 入口代码未捕获报错：JS入口文件（一般为index.js、App.js）初始化阶段存在语法错误、逻辑异常，Debug环境会弹出红屏提示，但Release环境无提示直接触发闪退，可连接设备后执行adb logcat *:S ReactNative:V ReactNativeJS:V查看运行时日志定位具体报错
• 全局异常捕获缺失：项目未配置全局异常捕获逻辑，启动阶段的未捕获异常直接导致应用进程被系统杀死

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