Expo构建的React Native APK在真机启动后闪退求助

• 权限配置遗漏
  Expo Go会自动处理运行时权限请求，但独立APK需要在app.json中显式声明所需权限。比如你的应用用到了存储、相机功能，要确保android.permissions数组包含对应权限：

  {
    "expo": {
      "android": {
        "permissions": ["READ_EXTERNAL_STORAGE", "WRITE_EXTERNAL_STORAGE", "CAMERA"]
      }
    }
  }
  

• 环境变量未正确打包
  本地开发时.env文件的变量在Expo Go中能正常读取，但构建APK时如果没有正确注入这些变量，会导致初始化逻辑失败。可以通过expo-constants的Constants.manifest.extra获取变量，构建前确认运行expo build:android时环境变量已正确加载，或者使用expo build:android --release-channel production指定渠道打包。

• 第三方库需额外配置
  部分依赖库在Expo Go中预构建了兼容版本，但独立APK需要手动添加配置插件或参数。比如使用react-native-maps时，必须在app.json中配置谷歌地图API密钥：

  {
    "expo": {
      "android": {
        "config": {
          "googleMaps": {
            "apiKey": "你的谷歌地图API密钥"
          }
        }
      }
    }
  }
  

  检查你所用的第三方库文档，确认独立构建所需的配置项。

• 抓取日志定位具体错误
  直接通过adb日志查看闪退原因是最有效的方式：

  1. 用USB连接真机并开启调试模式
  2. 运行命令：adb logcat *:E
  3. 启动闪退的应用，查看输出的错误日志，比如找不到类、权限被拒绝、资源加载失败等信息，根据日志定位问题。

• 清理构建缓存后重试
  旧的构建缓存可能导致异常，尝试清理后重新构建：

  # 清理本地开发缓存
  expo r -c
  # 清理Expo构建缓存并重新打包
  expo build:android --clean
  

• 签名配置错误
  如果是自行签名的APK，确认app.json中的签名配置完全正确：

  {
    "expo": {
      "android": {
        "keystore": {
          "path": "./my-key.keystore",
          "alias": "my-key-alias",
          "password": "密钥库密码",
          "keyPassword": "密钥密码"
        }
      }
    }
  }
  

  若使用Expo自动签名，确保构建过程中没有报错，签名文件生成正常。

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