三星S10e无线ADB调试频繁断连问题排查求助

我在三星S10e（Android 12）设备上使用无线ADB调试时，连接状态极不稳定：偶尔能正常使用，但频繁出现断连后立即重连的情况，有时会直接处于断开状态，必须进入开发者选项重启无线调试功能才能恢复。该问题常发生在启动Flutter应用时，直接导致应用启动失败。最直观的表现是手机频繁振动，“无线调试已连接”的通知反复出现又消失。

偶尔还会碰到“卸载旧版本失败”的错误，这种情况我会手动删除应用解决。我怀疑问题要么出在设备本身，要么是路由器设置导致连接不可靠。

错误日志示例 #

设备离线错误 #

Launching lib/main.dart on SM G970F in debug mode...
Running Gradle task 'assembleDebug'...
✓  Built build/app/outputs/flutter-apk/app-debug.apk.
Installing build/app/outputs/flutter-apk/app-debug.apk...
Error: ADB exited with exit code 1
adb: device offline
Error launching application on SM G970F.

安装失败错误 #

Launching lib/main.dart on SM G970F in debug mode...
Running Gradle task 'assembleDebug'...
✓  Built build/app/outputs/flutter-apk/app-debug.apk.
Installing build/app/outputs/flutter-apk/app-debug.apk...
Error: ADB exited with exit code 1
Performing Streamed Install

adb: failed to install /Users/gustek/my-github/liveness_mlkit/build/app/outputs/flutter-apk/app-debug.apk:
Error launching application on SM G970F.

相关环境信息 #

ADB版本 #

Android Debug Bridge version 1.0.41
Version 33.0.3-8952118

Android Studio版本 #

Android Studio Flamingo | 2022.2.1 Patch 2
Build #AI-222.4459.24.2221.10121639, built on May 12, 2023
Runtime version: 17.0.6+0-17.0.6b802.4-9586694 x86_64
VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.

可能原因及排查建议 #

网络层面问题 #

• 优先排查路由器：确保电脑和手机连接同一2.4GHz WiFi频段（5GHz频段易出现兼容性问题，尤其是老设备）；关闭路由器的AP隔离功能，避免设备间通信被阻断；重启路由器，清除可能的网络缓存。
• 测试直连：用手机热点代替路由器，让电脑连接手机热点再尝试无线ADB，排除路由器本身的问题。
• 固定IP：给手机设置静态IP地址，避免DHCP自动分配导致IP变动引发断连。

设备与系统层面问题 #

• 关闭省电模式：三星Android 12的省电模式会限制后台网络活动，可能主动切断ADB连接，建议调试时关闭省电模式，同时在电池优化中把ADB相关进程设置为“不优化”。
• 重置开发者选项：进入开发者选项，点击“重置所有偏好设置”，恢复默认调试配置后重新开启无线调试。
• 更新系统：检查三星S10e的系统更新，Android 12的部分版本存在无线ADB的兼容性bug，更新到最新补丁可能解决问题。
• 关闭VPN/代理：电脑或手机上的VPN、代理工具会干扰ADB的网络连接，调试时暂时关闭。

ADB与工具层面问题 #

• 重启ADB服务：在终端执行adb kill-server，再执行adb start-server，重置ADB连接状态。
• 重新配对无线ADB：删除已配对的设备，重新进入开发者选项的无线调试页面，通过配对码重新建立连接，避免旧配对信息异常。
• 调整ADB版本：当前使用的ADB版本33.0.3可能和Android 12存在兼容性问题，尝试降级到32.x版本或更新到最新稳定版（通过Android Studio的SDK管理器操作）。
• 清理Flutter缓存：执行flutter clean后重新构建项目，避免旧构建缓存导致的安装冲突。

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