React Native生成的app-debug.apk安装后无法在手机打开是什么原因

构建环节隐性异常 #

• JS 包未正确嵌入：构建过程中react-native bundle步骤静默失败，入口 JS bundle 未被正常打包进 APK 的 assets 目录，应用启动时找不到执行入口直接闪退
• 架构适配缺失：构建配置中仅指定了部分 ABI 架构的 so 库生成规则，比如仅生成 x86 架构包但目标手机为 ARM 架构，启动时无法加载对应原生库崩溃
• 签名/配置冲突：debug 变体的签名文件被意外修改，和手机中已安装的同包名应用签名冲突；或是 build.gradle 中配置的 minSdkVersion 高于目标手机的安卓系统版本，安装后无法拉起
• 混淆规则错误：debug 构建变体意外开启了代码混淆，未添加 React Native 官方要求的混淆白名单，核心运行类被误删导致启动失败

依赖与代码问题 #

• 依赖兼容冲突：项目新增的第三方依赖和当前 React Native 版本存在隐性兼容问题，构建阶段不会抛出报错，运行时触发未捕获异常直接崩溃
• 入口逻辑异常：入口文件 index.js/App.js 中新增的初始化逻辑存在运行时错误，比如启动阶段直接调用未授权的原生模块、访问不存在的全局变量，连接 Metro 调试时的热更新逻辑会规避部分异常，但离线打包后运行直接触发崩溃
• 资源加载失败：新增的图片、配置等资源文件存在中文命名、特殊字符命名、大小写不匹配问题，构建阶段不会校验报错，运行时加载资源失败触发崩溃

目标设备环境问题 #

• 系统权限拦截：国产定制 ROM 默认拦截应用启动所需的基础权限（存储、网络等），首次启动未弹出权限申请框直接被系统拦截闪退
• 设备缓存冲突：手机中残留过同包名应用的旧版本缓存数据，新旧版本的本地缓存结构不兼容，启动读取缓存时触发异常崩溃

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