使用eas build -p android构建的APK无法在手机打开求助

排查与修复步骤 #

1. 重新构建并查看完整日志 #

运行eas build -p android --clear-cache，全程盯紧构建日志，重点抓Error、Failed标记的内容。很多启动失败的根源是构建阶段就存在隐性错误，只是没中断构建流程。

2. 核对项目配置文件 #

• 检查app.json/app.config.js：
  • 确保android.package是唯一合法的包名（比如com.yourteam.yourapp），别用默认的通用值；
  • 清理不必要的敏感权限，过度权限可能导致系统拦截启动。
• 检查eas.json：
  • 确认构建使用的profile对应的android.buildType正确——开发版APK依赖Expo Go，生产版需要独立构建配置。

3. 本地调试复现问题 #

• 先在本地跑npx expo run:android，如果同样启动失败，问题出在代码本身：
  • 查入口文件（App.js/index.js）的语法错误、未捕获的Promise异常；
  • 验证第三方依赖是否适配当前Expo SDK版本，尤其是原生模块（如支付、地图库），可能需要更新依赖或补充适配配置。
• 如果本地能正常运行，仅EAS构建包有问题：
  • 去EAS Dashboard对应构建任务页点击「Clear cache」，重新构建；
  • 尝试用eas build -p android --profile development构建开发版APK，测试能否启动。

4. 检查APK签名与安装权限 #

• 确认生产版APK已正确签名：EAS构建需要配置签名密钥，未签名包在部分设备上无法正常启动。可在eas.json中配置android.signing，或使用EAS托管签名服务。
• 安装时确保设备开启了「允许来自未知来源的应用」权限，安卓10+设备还要给安装用的工具（浏览器/文件管理器）开启「安装未知应用」权限。

5. 用设备日志定位具体错误 #

把设备连电脑，运行adb logcat *:E查看系统错误日志，过滤你的应用包名相关条目：

• 若看到AndroidRuntime: FATAL EXCEPTION，直接对应代码崩溃点；
• 若看到PackageManager: Package [包名] has no certificates，说明签名配置有问题。

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