远程调试常见问题排查手册
连接被拒绝（Connection Refused）
现象
adb connect 手机IP:5555 报错"connection refused"；或 Phone Agent 启动时报连接失败。
排查流程
- 手机和电脑是否同一 WiFi — 跨网段（比如一个在公司主 WiFi、一个在访客 WiFi）肯定连不上
- 手机上 TCP/IP 模式是否开启 — Android 需要先插 USB 跑一次
adb tcpip 5555 - 防火墙是否阻止 5555 端口 — Windows Defender / 企业网络 / 路由器级防火墙
- IP 是否变了 — 手机切 WiFi 后 IP 会变，
adb devices查不到时大概率是 IP 变了 - 端口冲突 — 极少数情况 5555 被其他服务占用，换端口
adb tcpip 5556
连接频繁断开
现象
第一次 adb devices 能看到，执行任务中途突然设备消失。
排查流程
- WiFi 信号 — 手机离路由器远、穿墙多导致信号不稳定
- 省电模式 — 某些 Android ROM 在 WiFi 信号弱时自动断开无线调试来省电
- 重启 TCP/IP —
adb tcpip 5555重新开启一次 - 改用有线 USB — 如果场景允许，有线比无线稳定得多
手机重启后无线失效
现象
重启手机后 adb devices 空列表，之前配好的 WiFi 连接全没了。
排查流程
Android 设备重启后 TCP/IP 模式默认会被关闭——这是 Google 的安全设计，防止恶意应用滥用无线调试。鸿蒙设备不会被关闭。
解决办法：USB 插一次重新 adb tcpip 5555，然后 adb connect。
hdc tconn 找不到设备
现象
鸿蒙设备用无线调试，但 hdc tconn 连不上。
排查流程
- 开发者选项里"无线调试"开关是否真的打开
- 手机上显示的 IP 和端口号（鸿蒙可能显示 5037 而不是其他）
- 电脑上
hdc list targets有线能否看到设备 - 鸿蒙重启后无线调试仍保持（鸿蒙不会像 Android 那样重置）
IPv6 / 双栈网络
现象
adb connect 时电脑解析到 IPv6 地址，导致连接失败。
解决办法
手动指定 IPv4 地址：adb connect 192.168.x.x:5555，不要用主机名。
企业网络限制
现象
公司网络通常有 AP 隔离（Client Isolation），设备之间互相连不上。
解决办法
- 用手机热点让电脑和另一台手机都连同一热点（热点本身不会 AP 隔离自己的客户端）
- 或换用有线 USB
- 或通过云手机服务（AutoGLM 2.0 的设计方向）
排查流程图
无线连接失败
├─ adb connect / hdc tconn 报错？
│ ├─ connection refused → IP/端口/防火墙
│ ├─ no route to host → 跨网段 / AP 隔离
│ └─ 超时 → WiFi 信号差 / 手机 TCP/IP 模式关了
├─ adb devices 能看到但标记 unauthorized？
│ └─ 手机上点允许（无线也需要首次授权）
└─ 连接成功但中途断开？
└─ WiFi 信号 / 省电模式 / 改用有线