Android模拟器与Ionic 7热加载启动失败问题求助

问题重现 #

多次执行以下命令后，Android模拟器无法正常启动：

ionic cap sync android && ionic cap run android -l --external --host=localhost --disable-host-check --target="Pixel_4_API_31"

命令输出报错：

[capacitor] Installing xxxxx\android\app\build\outputs\apk\debug\app-debug.apk...
[capacitor] Starting application activity xxx.app/xxx.MainActivity...
[capacitor] ADBs is unresponsive after 5000ms, killing server and retrying...
[capacitor] Error: Command failed: xxxx\AppData\Local\Android\Sdk\platform-tools\adb -s emulator-5554 shell am start -W -n xxx/xxx.MainActivity
[capacitor] adb.exe: device still authorizing

已尝试的操作均无效：

• adb kill-server + adb start-server
• 任务管理器终止相关进程
• 重启电脑
• 模拟器开发者选项中撤销权限

可能的原因与解决方案 #

1. ADB与模拟器版本不兼容（更新引发的常见故障） #

若近期更新了Android SDK Platform Tools（ADB）或Android Emulator，大概率是版本不匹配导致：

• 打开Android Studio的SDK Manager，切换到SDK Tools标签
• 勾选"Show Package Details"，查看SDK Platform Tools和Android Emulator的版本列表
• 选择上一个稳定版本安装（比如当前是34.0.5，回退到34.0.4）
• 安装完成后，执行adb kill-server && adb start-server，重启模拟器再测试

2. 彻底清除模拟器授权缓存 #

仅在开发者选项撤销权限可能无法完全清除缓存：

• 关闭模拟器，找到模拟器缓存目录：C:\Users\<你的用户名>\.android\avd\<模拟器名称>\cache
• 删除该目录下所有文件
• 重新启动模拟器，在弹出的「允许USB调试」对话框中勾选「始终允许此计算机」并确认

3. 排查防火墙/安全软件拦截 #

Windows防火墙或第三方安全软件可能阻断ADB与模拟器的通信：

• 暂时关闭Windows防火墙（控制面板→系统和安全→Windows Defender防火墙→启用或关闭Windows Defender防火墙）
• 退出第三方杀毒软件/安全卫士
• 执行adb devices，确认模拟器状态从unauthorized变为device后，重新运行Ionic命令

4. 重置ADB授权密钥 #

ADB密钥文件损坏会导致持续授权失败：

• 删除C:\Users\<你的用户名>\.android\目录下的adbkey和adbkey.pub文件
• 执行adb kill-server，再执行adb start-server
• 重启模拟器，重新完成授权流程

5. 更换模拟器实例 #

当前模拟器配置可能存在异常：

• 打开Android Studio的AVD Manager，创建新的Pixel 4 API 31模拟器（使用默认硬件配置）
• 启动新模拟器，执行adb devices确认授权状态正常
• 运行Ionic命令测试是否能正常启动应用

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