很多人在 macOS 上第一次尝试 ADB 无线调试,习惯性敲完 adb tcpip 5555 和 adb connect <手机IP>:5555 就等着看 connected,结果等来的是 error: protocol fault (couldn't read status message): no error。如果这时候手机还连着 USB,烦躁感会直接翻倍——明明有线好好的,怎么一到无线就各种幺蛾子。这篇文章就围绕这条报错链路,把 macOS 环境下无线调试从配对、连接到稳定使用的完整排查过程写清楚,尤其是 Protocol Fault 和端口占用这两个让人摸不着头脑的问题。
这篇文章适合谁看?第一类是刚接触 ADB 无线调试的移动开发或测试同学,需要一套能直接照做的排查路径;第二类是被 protocol fault 反复折磨、搜了半天没找到靠谱答案的进阶用户;第三类是想彻底搞懂 ADB over Wi-Fi 底层机制、避免以后再踩坑的折腾党。我会结合自己实际踩坑的经历,把能复现的步骤、能直接执行的命令、能解释清的原理都放进来。
1. 无线调试不是开个开关就行:先搞清楚 ADB over Wi-Fi 的完整链路
排查任何问题之前,得先知道"正常情况应该长什么样"。ADB 无线调试看着就一条 adb connect 的事,但背后至少涉及四层协作:ADB Server、mDNS 服务发现、TCP 连接建立、以及 adbd 的认证和会话管理。
1.1 ADB 工作模式的两个阶段:Pairing 和 Connecting
从 Android 11 开始,官方推荐的方式是"无线调试"面板里的配对码模式,这其实是把无线调试拆成了两个阶段。
第一阶段是配对(Pairing)。手机开启无线调试后,会弹出一个六位配对码,同时开启一个临时的 mDNS 服务。macOS 上的 adb pair 命令通过 mDNS 发现设备,用配对码完成密钥交换。这个阶段走的是 37000 到 39999 之间的随机端口,本质上是 TLS 加密的配对通道。
第二阶段才是真正的连接(Connecting)。配对成功后,adbd 会监听一个固定端口(通常是你用 adb tcpip 指定的端口,或者无线调试面板里显示的端口),macOS 上的 adb client 通过 adb connect IP:端口 建立 TCP 连接。连接建立后,还要经过 RSA 密钥认证——如果电脑的调试授权没有通过,就会卡在 unauthorized 状态。
很多人在 macOS 上遇到的问题,恰恰是第一阶段 mDNS 发现失败,或者第二阶段 RSA 授权缓存出错,导致表面上看是 connect 成功但马上断开,或者直接 cannot connect。Protocol Fault 则是比连接失败更深一层的协议级异常,后面单独说。
1.2 macOS 环境准备:该装的、该开的、该授权的
在排查具体报错之前,我建议先把 macOS 侧的环境整理干净,排除掉基础环境干扰。
code复制brew install android-platform-tools
安装完以后确认版本,adb version 至少是 1.0.41 以上,太老的版本对 Android 12+ 设备支持不好。然后确认 adb 所在的路径在 PATH 里,macOS 上常见路径是 /opt/homebrew/bin(Apple Silicon)或 /usr/local/bin(Intel)。
然后是系统设置里的三个关键授权:
- “隐私与安全性”里的“本地网络”权限,必须允许终端 App 访问本地网络,否则 mDNS 广播和连接请求会被 macOS 直接拦掉。
- “开发者模式”在 macOS 上不是必须的,但如果用了 Xcode 的命令行工具,要确保
adb使用的是 Homebrew 版本,而不是 Xcode 自带的旧版。用which adb检查。 - 手机侧开发者选项里的“USB 调试”和“无线调试”都要保持开启,且 USB 连接状态要正常。
我见过不少案例,排查了半天 Protocol Fault,最后发现是 macOS 的防火墙把 adb 的出站连接拦了。如果你开了第三方防火墙(比如 Little Snitch),第一次跑 adb connect 时务必允许 adbd 相关的连接请求。
1.3 一个小测试:先确认 mDNS 能发现设备
在跑 adb connect 前,先看一眼设备能不能被发现:
code复制adb mdns services
正常会输出类似 _adb-tls-connect._tcp 和 `_
