Expo构建APK成功但启动崩溃问题求助

核心排查方向 #

1. 处理ProGuard/R8混淆问题 #

Preview构建默认会开启代码混淆，部分原生库（如BLE相关、AWS Amplify）需要保留特定规则才能正常运行：

• 在app.json/app.config.js中添加ProGuard规则：

  "android": {
    "bundle": {
      "enableProguard": true,
      "proguardRules": [
        "-keep class com.amazonaws.** { *; }",
        "-keep class com.polidea.** { *; }", // 适配react-native-ble-plx
        "-keep class com.blemanager.** { *; }" // 适配react-native-ble-manager
      ]
    }
  }
  

• 若不确定具体规则，可临时关闭混淆验证：将enableProguard设为false，重新构建APK测试是否还崩溃。

2. 清理冗余/冲突依赖 #

你的package.json存在大量重复或兼容性风险的依赖：

• 移除重复功能库：比如多个国家选择器、多个Google地址自动完成组件，保留一个即可；
• 删除废弃/无用依赖：
  • expo-permissions：Expo 49已弃用，改用各模块自带的权限API（如expo-location.requestPermissionsAsync）；
  • react-native-eject：Managed Workflow无需执行eject操作；
  • install、watchman：属于开发工具，不应作为项目依赖；
• 解决库冲突：同时引入react-native-ble-manager和react-native-ble-plx两个BLE库，大概率会导致原生层冲突，保留一个即可；
• 检查版本兼容：比如native-base 3.x与Expo 49的适配性，建议升级到最新兼容版本。

3. 验证环境变量配置 #

生产构建中若缺失必要环境变量，会导致启动崩溃：

• 确保eas.json的preview profile中配置了所有所需环境变量：

  "build": {
    "preview": {
      "env": {
        "API_URL": "your-api-url",
        "FIREBASE_API_KEY": "your-key"
      }
    }
  }
  

• 代码中避免直接使用未定义的环境变量，添加默认值或空值判断。

4. 检查闪屏与启动逻辑 #

• 确认app.json中的闪屏资源路径正确，图片格式/尺寸符合Android要求；
• 检查expo-splash-screen的使用：确保在App启动逻辑中正确调用SplashScreen.hideAsync()，没有阻塞主线程的同步操作。

5. 获取详细崩溃日志 #

通过logcat获取精确错误栈，定位问题根源：

1. 用USB连接设备到电脑，打开Android Studio的Logcat；
2. 过滤Error级别日志，启动崩溃的APK，查看具体的崩溃类、方法及原因；
3. 或使用命令行：adb logcat *:E，捕获崩溃信息。

6. 简化构建测试 #

• 临时移除非核心库（如BLE、地图、第三方UI库），构建最小可运行版本，逐步排查是哪个库导致的崩溃；
• 对比开发环境与构建环境的差异：比如开发环境使用expo start，构建是原生编译，某些仅在web端生效的库（如canvas、react-google-autocomplete）可能在Android构建中引发问题。

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