Android 模拟器启动失败、黑屏与 WHPX 虚拟化排查

一、 核心故障表现与常见报错

• 启动即闪退：点击运行模拟器后，弹出短暂窗口后立即消失，Event Log 提示：

  The emulator process for AVD Pixel_... was killed.
  Emulator: emulator: ERROR: x86 emulation currently requires hardware acceleration!
  CPU acceleration status: HAX kernel module is not installed!

• 无限黑屏或开机动画卡死：模拟器外壳能加载出来，但屏幕长久全黑，或者停留于 “Google” / “Android” Logo 进度条数小时不动。
• 系统功能冲突：与电脑上已安装的 WSL 2、Docker Desktop 或 Hyper-V 冲突，导致传统 HAXM 驱动彻底失效。

二、 故障根源解析：为什么模拟器跑不起来？

现代 Android 模拟器运行 x86_64 系统镜像，底层严重依赖 CPU 的硬件虚拟化指令集（Intel VT-x 或 AMD-V / SVM）。

在 Windows 10 / 11 时代，Google 已正式废弃过时的 Intel HAXM 驱动，全面转向微软原生的 Windows Hypervisor Platform (WHPX / Windows 虚拟机监控程序平台)。当以下条件任一不满足时，模拟器均会崩溃：

1. 主板 BIOS 中的 CPU 虚拟化功能被默认关闭。
2. Windows “开启或关闭 Windows 功能” 中未勾选 WHPX 驱动。
3. 模拟器 GPU 渲染模式与当前显卡驱动不兼容（如双显卡笔记本直连核显崩溃）。
4. AVD 镜像文件被默认放置在 C 盘，而 C 盘剩余空间不足 10GB。

三、 标准排查与手动修复四步法

步骤 1：确认主板 BIOS 虚拟化是否开启

按下快捷键 Ctrl + Shift + Esc 打开任务管理器，切换到“性能”标签页，点击左侧的“CPU”：

观察右下角信息中的 “虚拟化” 状态：

• 如果显示为“已启用”：说明硬件支持完好，跳至步骤 2。
• 如果显示为“已禁用”：需重启电脑，根据主板型号连续按下 Del / F2 / F12 进入 BIOS，在 Advanced 或 CPU Configuration 中找到 Intel Virtualization Technology (VT-x) 或 SVM Mode，将其设置为 Enabled，按 F10 保存并重启。

步骤 2：启用 Windows Hypervisor Platform (WHPX)

在 Windows 搜索框输入并打开：“启用或关闭 Windows 功能”（或运行 optionalfeatures.exe）。

在弹出的列表中找到并勾选：

• ☑ Windows 虚拟机监控程序平台 (Windows Hypervisor Platform)
• ☑ 虚拟机平台 (Virtual Machine Platform)

点击“确定”，等待 Windows 自动安装组件并按照提示重启计算机以使内核驱动生效。

步骤 3：调整 AVD 渲染模式为软件渲染排查黑屏

如果模拟器能拉起但画面长久黑屏，多为显卡驱动 OpenGL 渲染协商失败。打开 Android Studio 的 Device Manager：

1. 点击模拟器右侧的“笔形编辑图标 (Edit this AVD)”。
2. 点击左下角的 Show Advanced Settings。
3. 滚动到 Emulated Performance 区域，将 Graphics 由 Automatic 改为 Software - GLES 2.0。
4. 将 Boot option 改为 Cold Boot（冷启动），点击 Finish 保存。

---