无线 ADB 配对成功却连不上?先分清配对端口和连接端口
区分无线调试的配对、连接与 mDNS 发现,按短步骤核对端口和设备状态,避免把所有 Wi-Fi 调试都当成固定 5555。
“配对成功”不等于“已经建立调试连接”。 Android 无线调试有配对与连接两个环节;先核对正在用哪一个端口,再看自动发现,不要反复往同一个配对端口执行连接。
本文讨论手机设置里的无线调试配对流程,资料核对于 2026 年 9 月 16 日。它不同于某些设备预先开放的固定 TCP 调试端口,也不代表任何投屏软件都支持这套接入方式。本文未操作设备或进行实测。
先认清三个名字
AOSP 将无线调试的配对服务与 TLS 连接服务分开,并分别使用 _adb-tls-pairing 和 _adb-tls-connect 进行发现。传统 adb tcpip 对应的是另一类服务,不能只因它们都经过 Wi-Fi 就当成相同模式。AOSP 架构说明
| 你看到的东西 | 用来做什么 |
|---|---|
| 配对窗口里的地址、端口与配对码 | 完成电脑与手机的配对 |
| 无线调试连接地址与端口 | 建立实际调试连接 |
| 自动发现结果 | 帮电脑找到服务,不替代连接结果核对 |
建议每次都读取手机当前显示的信息,不把以前记下的端口当成永久配置。
用最短的顺序核对
Android 官方说明,手机上的这类无线调试支持 Android 11 及以上,电脑与手机应位于同一无线网络,并使用更新的 SDK Platform Tools。官方接入说明
仅在自己拥有或获准调试的设备上操作。下面使用占位符,执行前替换,不能原样粘贴:
adb version
adb pair PHONE_IP:PAIRING_PORT
adb devices -l
按提示输入手机显示的配对码。如果已出现正常连接的目标,就不必为了完成教程再连一次。若配对成功但列表中没有目标,核对手机当前的连接端口,再执行:
adb connect PHONE_IP:CONNECTION_PORT
adb devices -l
pair 用于配对,connect 用于 TCP/IP 连接,devices -l 用于列出连接设备。手册中 connect 省略端口时默认使用 5555;这不意味着手机无线调试的连接端口一定是 5555,应明确填写实际端口。ADB 命令手册
以上命令只是一条排查路径,不保证每款 ROM 的菜单和行为完全一致。
手动能连,自动却找不到,查发现环节
ADB 的无线自动发现依赖 mDNS。手动指定地址连接成功,而自动连接失败时,应优先检查发现环节,而不是立即删除配对。当前官方文档也更新了针对新版 ADB 的排查命令;不要把新版命令或环境配置不加区分地套给旧工具。官方无线连接排障
可以先在当前工具中查看 adb help,确认所支持的 mDNS 命令。记录版本、是否发现连接服务、手动连接结果。如果发现结果为空,它只能说明这次没有获得发现结果,排障时还应核对手机是否正在广播、工具配置与网络环境,不宜仅凭这一项就认定手机故障。
为什么不建议第一步就重置一切?
建议先保留证据,再一次改变一个条件:
- 配对失败:记录配对阶段报错,重新核对当前配对窗口,而不是改视频设置。
- 配对成功但连接失败:记录实际使用的是连接端口还是配对端口,并保留连接错误。
- ADB 已连接但投屏没画面:连接建立只是一个检查点,下一步应查投屏服务,不继续围着配对打转。
- 同一电脑运行多个工具:先确认各工具使用的 ADB 版本和服务配置,避免刚修好一边又影响另一边。
不要为了方便把调试端口直接暴露到公网,也不要把配对码或完整连接信息贴进公开反馈。提交问题时保留系统与工具版本、失败阶段和脱敏错误,就能少走很多重复排查的弯路。