AndroidStuidoDebug

记录一些在Android开发过程中遇到的一些Bug以及解决方法

一. 模拟器无法正常打开

Emulator failed to connect within 5 minutes
此报错常见于电脑死机未能正常关闭Android Studio的情况，意味着 Android 模拟器在启动过程中卡住，未能在 5 分钟内成功运行。这通常是由于系统资源不足、虚拟设备配置问题，或模拟器数据损坏引起的。

✅ 解决步骤（按顺序尝试）

1. 完全退出所有 Android 模拟器进程

打开任务管理器（Ctrl + Shift + Esc），强制结束以下进程：

• emulator.exe

• qemu-system-x86_64.exe

• adb.exe

然后重启 Android Studio。

2. 清除 AVD 缓存和锁文件

打开AVD配置目录：C:\Users\<你的用户名>\.android\avd\<your_avd_name>
删除里面的这几类文件：

• *.lock
• cache.img
• userdata-qemu.img

---

二. ksp Exception

1. 常见报错

1.1 StreamCorruptedException: invalid stream header: 00000000

• 原因: KSP 或 Gradle 缓存文件损坏，通常是增量编译产生的临时文件异常。
• 症状: 项目编译失败，错误发生在 :app:kspDebugKotlin 或类似任务。

1.2 Kotlin 与 KSP 版本不匹配

• 原因: KSP 插件版本前半段必须与 Kotlin 版本一致，否则会报错或生成损坏的代码。
• 症状: 编译报错或生成的代码异常。

2. 快速修复步骤

2.1 保证版本匹配

• build.gradle.kts (Project) :

  //apply false: 不在当前（根）模块应用，只是在子模块（比如 app）需要的时候再 apply
  plugins {
      id("com.android.application") version "8.7.3" apply false
      id("com.android.library") version "8.7.3" apply false
      id("org.jetbrains.kotlin.android") version "2.1.0" apply false
      id("org.jetbrains.kotlin.plugin.compose") version "2.1.0" apply false
  }

• build.gradle.kts (app) :

  plugins {
      id("com.android.application")
      id("com.google.devtools.ksp") version "2.1.0-1.0.29"
      id("org.jetbrains.kotlin.android") 
      id("org.jetbrains.kotlin.plugin.compose")
  }

• Kotlin 前半段版本必须和 KSP 前半段一致。
• Compose 插件也应与 Kotlin 版本兼容。

2.2 清理缓存和增量编译文件

Android Studio GUI 方式

1. Build → Clean Project
2. Build → Rebuild Project
3. File → Sync Project with Gradle Files

2.3 检查 Kotlin 编译器版本

命令行方式:

./gradlew app:dependencies --configuration debugCompileClasspath | findstr "kotlin-stdlib"

3. 小贴士

1. 升级 Kotlin 或 KSP 时，先清理项目再同步依赖，避免旧缓存干扰。
2. 使用 apply false 在根项目声明插件版本，子模块再应用，可以统一版本管理。
3. Windows 下如果报缓存或锁文件问题，可关闭 Android Studio，删除 .gradle 和 build 文件夹，再重启。

---

三.