Android Studio模拟器正常工作但应用无法运行如何解决

先定位根因，不要盲目做清理操作 #

所有跳过查错直接清缓存、重启的操作都是碰运气，先找明确的报错信息：

• 打开Android Studio底部Logcat面板，顶部设备选当前运行的模拟器实例，日志级别切到Error，过滤栏填你应用的包名，找第一条标红的异常栈，90%的问题在这里能直接看到原因。
• 查看底部Build、Run两个面板的红色输出，常见的安装失败、Gradle编译错误都会直接打在这两个面板，不要点完运行就最小化控制台等结果。
• 如果点运行后模拟器完全没反应，执行adb devices命令看当前连接的模拟器状态是不是device，如果显示offline或者unauthorized属于调试通道没连上，和应用本身没关系。

分场景处理 #

场景1：应用根本没装上模拟器 #

• 检查模拟器剩余存储空间：打开模拟器设置-存储，剩余空间不足1G时会静默安装失败，要么给模拟器扩容，要么删掉模拟器里闲置的应用、清理缓存腾出空间。
• 彻底卸载残留：之前做的wipe data不一定能清掉系统级的应用残留，打开模拟器应用列表找有没有你开发的App旧图标，有就手动卸载；或者在终端执行adb uninstall <你的应用完整包名>，返回Success后再重新安装。
• 排查ABI匹配问题：打开AVD管理器看当前模拟器的CPU架构（x86_64/arm64-v8a），再检查模块级build.gradle里ndk.abiFilters配置，有没有把模拟器对应的架构加进去，漏加的话补上再同步Gradle重新编译。
• 关闭热重载功能：打开设置-Build, Execution, Deployment-Debugger-HotSwap，把Apply Changes、代码热替换相关的开关全部关掉，这类功能经常导致安装包签名冲突，触发安装失败。

场景2：应用装上了，点图标闪退/黑屏 #

• 检查清单文件配置：打开AndroidManifest.xml，确认启动Activity有没有加正确的入口过滤器，少了下面这段配置系统会找不到启动入口，点运行直接弹回桌面：

  <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
  </intent-filter>
  

• 排查混淆问题：如果debug包开了minifyEnabled true，Logcat报ClassNotFoundException，就是混淆规则没写对，把Application类、启动页类、第三方SDK需要的类给误删了，先把debug包的混淆关掉验证，再补对应的keep规则。
• 检查版本匹配：确认你项目配置的minSdk版本小于等于当前模拟器的系统API等级，比如项目minSdk设成33，开Android 12（API31）的模拟器就会直接启动失败。
• 权限适配检查：如果targetSdk版本在33及以上，启动时申请的通知、存储等运行时权限没做适配的话，会直接触发安全异常崩溃，对照Logcat的权限报错补适配逻辑。

场景3：点运行按钮后完全不触发安装流程 #

• 检查运行配置：点顶部运行按钮旁的配置下拉框，选Edit Configurations，确认启动项选的是Default Activity，不是指向一个已经删掉的Activity类；确认部署目标选中了当前启动的模拟器。
• 重启ADB服务：在终端依次执行以下命令重置调试桥：

  adb kill-server
  adb start-server
  adb devices
  

  等输出里模拟器状态显示为device再重新点运行。
• 检查Gradle JDK匹配：打开设置-Build, Execution, Deployment-Build Tools-Gradle，确认Gradle JDK版本和当前项目的AGP版本匹配，比如AGP 8.0+必须用JDK17，版本不匹配会出现静默编译失败，没有明显弹窗提示。
• 清理本地构建缓存：之前执行的Invalidate Caches只清Android Studio的缓存，不会清项目本地构建缓存，关掉Android Studio，进到项目根目录，删掉.gradle、.idea、app/build三个文件夹，重新打开AS等Gradle同步完成再编译。

兜底方案 #

上面步骤都试过还不行的话：

• 不要在原有故障AVD上反复调试，直接新建一个全新的模拟器实例，选和你项目minSdk匹配的系统镜像，不要导入旧模拟器的用户数据，用全新环境测试。
• 暂时关掉电脑上的Hyper-V（如果开了第三方安卓模拟器的话）、杀毒软件、安卓投屏类工具，这类软件会占用ADB调试端口，导致模拟器能启动但AS没法正常安装应用。

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