Android Studio调试首次启动失败：点击调试按钮后应用未自动运行

可能的首次启动失败原因 #

• ADB连接延迟：Android设备与IDE的adb连接存在短暂滞后，构建完成后设备还未就绪，导致启动指令未被正确接收，仅返回构建成功的提示。
• 默认Activity配置异常：虽然在Launch Options设置了“Default Activity”，但AndroidManifest.xml中对应Activity的intent-filter配置不完整（比如缺少MAIN action或LAUNCHER category），或是Android 12+版本未设置android:exported="true"，首次启动时系统无法识别启动页，二次启动时缓存了正确配置。
• IDE/ADB缓存冲突：Android Studio的构建缓存或adb服务缓存存在异常，首次构建后缓存未及时同步，导致启动逻辑出错，二次触发时缓存被强制刷新。
• 设备进程干扰：设备上残留的应用旧进程未完全清理，首次启动时进程冲突导致无法拉起，二次启动时旧进程被自动终止，新进程成功启动。

需要检查的设置及解决步骤 #

• 验证Manifest文件配置：确保默认Activity的声明包含完整的启动配置：

  <activity
      android:name=".MainActivity"
      android:exported="true"> <!-- Android 12+ 必填 -->
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />
          <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
  </activity>
  

• 清理IDE缓存：执行File > Invalidate Caches... > Invalidate and Restart，重启Android Studio后重新调试。
• 重置ADB连接：在Terminal中运行以下命令：

  adb kill-server
  adb start-server
  

• 检查设备开发者选项：确认“USB调试”和“通过USB安装应用”均已开启，避免权限限制导致启动失败。
• 重装应用：卸载设备上的目标应用后，重新构建并调试，排除旧应用残留的配置干扰。

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