在使用Mac进行安卓应用开发时,通过adb连接小米手机进行无线调试可以省去频繁插拔数据线的麻烦,但实际操作中很容易遇到连接失败的情况,下面将从常见原因出发,逐步给出对应的解决步骤。

一、基础环境检查
首先确认基础环境是否符合要求,这是连接成功的前提:
- Mac上已经正确安装Android SDK,并且adb命令可以正常调用,在终端输入
adb version可以查看版本信息,若提示命令不存在,需要将SDK的platform-tools目录添加到系统环境变量中。 - 小米手机和Mac处于同一个局域网下,可以通过互相ping对方的IP地址确认网络连通性,比如Mac终端输入
ping 手机IP地址,能收到回复说明网络正常。 - 小米手机已经开启开发者选项,并且打开了USB调试功能,部分系统版本还需要额外开启无线调试选项。
二、常见失败原因及解决方法
1. 未开启无线调试或端口未正确配对
小米手机MIUI 13及以上版本默认将无线调试独立为单独选项,需要先开启该功能:
进入手机设置-更多设置-开发者选项,找到无线调试开关并打开,系统会显示当前无线调试的IP和端口,比如192.168.1.100:5555。
在Mac终端输入以下命令尝试连接:
adb connect 192.168.1.100:5555
如果提示failed to connect,可以先通过USB连接手机和Mac,执行以下命令设置无线调试端口:
# 先通过USB连接手机,设置tcpip端口为5555 adb tcpip 5555 # 断开USB后,再尝试无线连接 adb connect 192.168.1.100:5555
2. 手机端授权未通过
首次无线连接时,手机端会弹出授权提示,需要勾选始终允许这台计算机调试并点击允许。如果之前误点了拒绝,可以进入手机开发者选项,点击撤销USB调试授权,然后重新执行连接步骤,让手机重新弹出授权提示。
3. adb服务异常或端口被占用
如果adb服务本身出现异常,或者5555端口被其他进程占用,也会导致连接失败,可以先重启adb服务:
# 关闭adb服务 adb kill-server # 重新启动adb服务 adb start-server # 查看当前连接的设备 adb devices
如果提示端口被占用,可以更换其他端口,比如将端口设置为6666,执行adb tcpip 6666后,再用新端口连接。
4. 系统防火墙或路由器限制
部分Mac的系统防火墙或者路由器会拦截adb的调试端口,导致无法连通。可以暂时关闭Mac的系统防火墙,路径为系统设置-网络-防火墙,关闭后再尝试连接。如果是公司或公共网络,需要确认路由器没有禁用局域网内的设备互访功能。
三、验证连接是否成功
连接完成后,在Mac终端输入adb devices,如果输出列表中显示对应的手机IP和端口,状态为device,说明连接成功,此时就可以脱离数据线进行无线调试了。
如果仍然连接失败,可以尝试更换手机的热点,让Mac连接手机热点后再尝试,排除局域网环境的问题。另外部分旧版本MIUI系统可能存在无线调试的兼容性问题,可以尝试升级系统到最新稳定版后再操作。