React Native Expo应用构建成功但安装后启动崩溃求助

一、先抓崩溃日志（最关键的一步） #

• Android设备操作：打开开发者选项，开启「USB调试」和「USB调试（安全设置）」，连接电脑后在命令行执行 adb logcat *:E，然后启动崩溃的应用，红色的错误日志就是问题根源。
• 没有电脑的话，登录Expo Dashboard找到你的项目，查看「Crash Reports」标签，里面会记录崩溃的堆栈信息。

二、逐一排查常见原因 #

1. 权限配置缺失 #

Expo Go会自动处理基础权限，但打包APK时必须手动在 app.json 里声明所需权限。比如用到相机、定位功能，就要在permissions数组里添加对应权限：

{
  "expo": {
    "permissions": ["android.permission.CAMERA", "android.permission.ACCESS_FINE_LOCATION"]
  }
}

漏加权限会导致系统启动时拦截应用，直接触发崩溃。

2. 依赖版本不兼容 #

• 执行 expo doctor 命令，它会自动检测依赖冲突、版本不匹配的问题，按照提示修复即可。
• 如果使用了Expo官方不支持的原生模块，不能用普通的expo build:android构建，需要切换到EAS Build流程。

3. 配置或环境变量错误 #

• 打包时是否正确注入了API密钥、服务器地址这类必要配置？如果参数缺失或错误，应用启动时读取不到关键信息就会崩溃。可以尝试执行 expo build:android --clear-cache 清除缓存后重新打包。
• 检查app.config.js里的配置项是否写错，确保打包时能正常读取。

4. 资源文件异常 #

图片路径写错、字体文件损坏等，都会导致应用启动时加载资源失败崩溃。可以执行 expo prebuild --clean 重新生成原生文件后再打包尝试。

5. SDK版本设置不合理 #

查看app.json里的android.minSdkVersion，如果手动修改过版本号，可能导致与系统不兼容，建议恢复到当前Expo SDK对应的默认版本。

三、额外建议 #

你提供的GitHub链接是APK文件，看不到项目源码，无法精准定位问题。建议分享项目源码仓库，或者把抓到的崩溃日志关键信息（比如堆栈跟踪内容）贴出来，这样能更快定位解决问题。

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