MAUI项目调试时卡在‘Waiting for debugger’界面求助
解决MAUI调试卡在“Waiting for debugger”的问题
- 检查调试器连接配置
- 确认Visual Studio已识别到Android模拟器:在Visual Studio的“运行”下拉菜单中查看是否能选中目标模拟器,若未识别,重启Android Studio模拟器和Visual Studio
- 开启模拟器的调试权限:进入模拟器的设置→系统→开发者选项,确保USB调试和无线调试(Android 11及以上支持)已开启
- 调整项目调试设置
- 打开MAUI项目属性,切换到“调试”选项卡,确认“启动调试器”已勾选,目标框架选择
.NET 8.0 (Android),目标Android版本设置为Android 14.0 (API level 34) - 取消勾选“启用快速部署(仅适用于调试)”,快速部署可能引发调试器连接异常
- 打开MAUI项目属性,切换到“调试”选项卡,确认“启动调试器”已勾选,目标框架选择
- 清理重建项目
- 右键点击解决方案,依次执行
Clean Solution和Rebuild Solution,清除编译缓存 - 手动删除项目目录下的
bin和obj文件夹,清理残留调试文件
- 右键点击解决方案,依次执行
- 重置ADB连接
- 打开命令提示符,执行
adb devices确认模拟器设备状态为device;若显示offline,执行adb kill-server后再执行adb start-server重启ADB服务
- 打开命令提示符,执行
- 排查API请求阻塞
- 检查应用启动阶段的API请求代码,确保未在UI主线程执行同步网络请求(这会导致UI阻塞,阻碍调试器附加),必须使用
async/await异步方式在后台线程处理网络操作
- 检查应用启动阶段的API请求代码,确保未在UI主线程执行同步网络请求(这会导致UI阻塞,阻碍调试器附加),必须使用
- 非调试模式下排查错误
- 通过Android Studio的Logcat查看应用日志:连接模拟器后打开Logcat,筛选应用包名,查看启动时的错误日志,定位问题点
内容的提问来源于stack exchange,提问作者Hakan
相关产品推荐
相关产品推荐

