Flutter无线调试：adb连接成功后调试器无法启动flutter run卡住

问题现象 #

通过adb connect成功连接三星手机设备，前期连接流程正常，assembleDebug构建流程跑完后，执行flutter run直接卡住，调试器无法启动。

运行环境 #

Flutter SDK 版本: Flutter 3.0.2
设备型号: Samsung Galaxy M31
CPU架构: Android ARM64
安卓版本: Android 12

解决方法 #

按顺序尝试，每操作完一步重跑flutter run验证即可：

• 先执行flutter clean清空历史构建缓存，再跑flutter pub get重新拉取依赖，排除旧构建产物和当前系统版本不兼容的问题
• 检查手机开发者选项：三星OneUI针对Android 12加了额外调试权限校验，必须手动开启「USB安装」「允许通过USB调试修改权限/模拟点击」两个选项，否则debug包装完后会卡在等待调试器附着阶段，不会弹出授权提示
• 无线adb连接时Flutter自动端口转发经常失效，手动执行adb reverse tcp:8080 tcp:8080做端口映射，跳过自动端口探测的卡住环节
• 执行flutter run -v打印详细日志，如果日志停在Waiting for observatory port to be available阶段，先卸载手机上已经安装的对应debug包，再依次执行adb kill-server、adb start-server、adb connect 你的设备IP:连接端口重启adb链路后重跑
• 适配Android 12的强制规则：Flutter 3.0.2的默认项目模板没有适配安卓12的组件导出要求，需要手动在android/app/src/main/AndroidManifest.xml的<application>标签，以及所有带<intent-filter>的Activity、Service标签下添加android:exported="true"属性，否则调试进程会被系统静默拦截，无报错直接卡住
• 操作前先关闭电脑端和手机端的所有代理、VPN，这类工具会拦截adb和Flutter调试器的本地通信，直接导致连接卡住

内容的提问来源于stack exchange，提问作者Rudr Thakur