Android Studio Ladybug通过Wi-Fi配对设备失败求助

问题背景 #

在Android Studio Koala | 2024.1.1 Patch 1 及后续升级到 Ladybug | 2024.2.1 Patch 1 版本后，尝试通过Wi-Fi调试三星Galaxy S23 Ultra物理设备时，无论用二维码还是配对码配对，都会卡在「正在连接设备，此过程最多需要2分钟」，超时后提示「连接设备时出错，请重新扫描尝试」，完全无法建立有效连接。

此前使用Jellyfish版本时，虽稳定性一般，但尝试2-3次即可成功连接并正常使用；升级后问题加剧，甚至需要花费半小时以上（含重启Android Studio、笔记本）才偶尔成功。

已尝试的无效操作：

• 重启笔记本（MS Surface Pro 8）
• 禁用设备MAC随机化功能
• 使用命令行操作Wi-Fi调试配对
• 设置设备与笔记本固定IP地址

额外现象：扫描二维码后，二维码变灰，Android Studio显示连接提示，同时设备「无线调试」对话框显示「userId@deviceName」为已配对设备，但加载动画无限旋转，最终笔记本端提示连接失败。

可行排查与解决方法 #

1. 重置ADB无线调试配对记录 #

• 关闭Android Studio及所有adb相关进程
• 在设备端：进入「开发者选项」→「无线调试」→ 长按已配对的笔记本设备条目，选择「取消配对」
• 在笔记本端：打开命令提示符/终端，执行命令：

  adb kill-server
  adb start-server
  adb pair <设备IP>:<配对端口>  # 替换为设备无线调试显示的配对IP和端口
  adb connect <设备IP>:<调试端口>  # 替换为设备无线调试显示的调试端口
  

  注意：配对端口和调试端口是两个不同的端口号，不要混淆。

2. 检查防火墙与网络权限 #

• 确保笔记本防火墙允许Android Studio（及adb.exe）通过私有网络通信
• 确认设备与笔记本处于同一Wi-Fi网络，且无VPN、代理或网络隔离限制（部分企业网络会拦截adb通信端口）

3. 降级ADB版本（针对新版本兼容性问题） #

部分新版本Android Studio自带的adb可能与三星设备存在兼容性问题：

• 下载对应旧版本的adb工具包（如对应Jellyfish版本的adb）
• 替换Android Studio安装目录下的platform-tools文件夹（路径一般为Android\Sdk\platform-tools）
• 重启Android Studio后重新尝试配对

4. 检查设备开发者选项设置 #

• 进入设备「开发者选项」→ 确保「无线调试」处于开启状态，且「USB调试」也保持开启（部分设备需要USB调试辅助激活无线调试）
• 尝试关闭「选择调试应用」的锁定状态，重新配对后再指定调试应用

5. 重置设备开发者选项 #

• 进入设备「开发者选项」→ 拉到最底部选择「重置开发者选项」，重新开启无线调试并配对

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