环境信息 #

• 主机：Windows
• 运行环境：搭载Android SDK的Podman容器
• Android API级别：30
• ABI：x86_64
• GPU模式：swiftshader_indirect
• 模拟器版本：36.2.12.0（build_id 14214601）

预期行为 #

模拟器应在30-60秒内完成启动，adb devices可显示设备处于在线状态。

实际行为 #

脚本启动模拟器进程但无法完成启动，日志如下：

Starting Android Emulator Instance 0
Command: emulator -avd avd_1 -port 5554 -gpu swiftshader_indirect -memory 2048 -cores 4 -partition-size 1024 -no-boot-anim -no-window -writable-system -skip-adb-auth -accel auto -netdelay none -netspeed full -cache-size 1024 -verbose
Emulator instance 0 started with PID 123
Waiting for emulator instance 0 to boot...
Waiting for boot to complete on emulator-5554...
[hangs here indefinitely]

相关代码 #

模拟器启动命令：

start_emulator() {
    local avd_name=$1
    local console_port=$2
    local adb_port=$3
    
    local EMULATOR_CMD="emulator -avd $avd_name"
    EMULATOR_CMD="$EMULATOR_CMD -port $console_port"
    EMULATOR_CMD="$EMULATOR_CMD -gpu $GPU_MODE"
    EMULATOR_CMD="$EMULATOR_CMD -memory 2048"
    EMULATOR_CMD="$EMULATOR_CMD -cores 4"
    EMULATOR_CMD="$EMULATOR_CMD -partition-size 1024"
    EMULATOR_CMD="$EMULATOR_CMD -no-boot-anim -no-window -writable-system"
    EMULATOR_CMD="$EMULATOR_CMD -skip-adb-auth"
    EMULATOR_CMD="$EMULATOR_CMD -accel auto -netdelay none -netspeed full"
    
    $EMULATOR_CMD &
    wait_for_boot $console_port
}

wait_for_boot() {
    local port=$1
    while ! adb -s emulator-$port shell getprop sys.boot_completed 2>/dev/null | grep -q "1"; do
        echo "Waiting for boot to complete on emulator-$port..."
        sleep 5
    done
}

已尝试的排查步骤 #

• 验证ADB服务器运行：adb devices可正常运行，服务器已启动
• 检查模拟器进程：进程处于运行状态但无响应
• 手动测试：直接运行模拟器命令出现相同问题
• 查看日志：adb logcat无输出（设备未启动）
• 重建AVD：删除并重新创建AVD，无变化
• 验证系统镜像：sdkmanager --list_installed显示已安装正确包
• 检查资源：容器已分配足够的RAM/CPU

疑问 #

1. 无配置变更时，Android模拟器突然无法启动的原因是什么？
2. Android模拟器与系统重启是否存在已知问题？
3. 还需检查哪些额外日志或调试步骤？
4. 该问题是否与重启后需重置的KVM/硬件加速有关？

附加信息 #

运行emulator -avd avd_1 -verbose显示卡在以下步骤后：

emulator: GPU emulation enabled using 'swiftshader_indirect' mode
...
[hangs - no further output]

重启前，Podman镜像、Android SDK安装包、脚本配置、系统资源均未变更，模拟器运行正常。

问题排查与解答 #

1. 无配置变更时模拟器突然无法启动的常见原因

• 硬件加速权限丢失：Windows重启后，WSL2环境的/dev/kvm设备权限可能重置，容器无法访问该设备，导致模拟器硬件加速失效，进而卡在GPU初始化阶段。
• SwiftShader缓存损坏：重启后模拟器的SwiftShader缓存文件可能损坏，导致GPU模式初始化失败。
• WSL2虚拟化状态异常：Windows重启后，WSL2的虚拟化服务未正常启动，或硬件虚拟化（VMX/SVM）被意外关闭。

2. Android模拟器与系统重启的已知关联问题

• WSL2环境下，系统重启后需确保虚拟化功能（BIOS中的VMX/SVM、Windows功能中的"虚拟机平台"和"适用于Linux的Windows子系统"）处于启用状态。
• Podman容器如果未配置持久化的设备挂载，重启后/dev/kvm的访问权限会丢失，导致模拟器无法启用硬件加速。
• 模拟器的临时状态文件（如AVD的缓存目录）在容器重启后可能残留异常数据，导致启动卡住。

3. 额外的调试与排查步骤

• 验证容器内KVM访问权限：
  在容器内执行：

  ls -l /dev/kvm
  # 应显示crw-rw-rw-权限，并且当前用户属于kvm组
  grep kvm /etc/group
  id $(whoami)
  

  如果权限不足，启动容器时需添加--device /dev/kvm和--group-add kvm参数。
• 检查WSL2虚拟化状态：
  在Windows命令行执行：

  systeminfo | findstr /i "Virtualization"
  # 确认"虚拟化已启用"为是
  wsl --status
  # 确认WSL版本为2
  

• 生成模拟器完整启动日志：
  执行更详细的日志命令：

  emulator -avd avd_1 -verbose -logcat *:v > emulator_full.log 2>&1
  

  查看日志中GPU初始化后的具体错误信息，比如是否有SwiftShader相关的加载失败。
• 测试禁用硬件加速：
  修改启动命令为-accel off，如果模拟器能正常启动，说明问题出在硬件加速配置上。
• 检查容器内核日志：
  在容器内执行dmesg，查看是否有与KVM、GPU相关的错误信息。

4. 与KVM/硬件加速的关联确认

是的，该问题大概率与重启后KVM/硬件加速的状态异常有关：

• Windows重启后，WSL2的KVM模块可能未自动加载，或容器未正确挂载/dev/kvm设备，导致模拟器无法使用硬件加速，转而依赖SwiftShader时出现卡住。
• 即使指定了-accel auto，当硬件加速不可用时，模拟器会尝试切换到软件加速，但SwiftShader在某些环境下可能因缓存或权限问题无法正常初始化，导致启动停滞。

临时修复建议 #

1. 重启WSL2环境：

   wsl --shutdown
   wsl
   

2. 重新启动容器时添加必要的权限参数：

   podman run --privileged --device /dev/kvm --group-add kvm ...
   

3. 清理模拟器缓存：
   在容器内删除AVD的缓存目录（通常位于~/.android/avd/avd_1/cache），然后重新启动模拟器。

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