在Mac上进行Android开发时，无线调试可以避免频繁插拔数据线，提升调试便利性，但很多用户在使用ADB连接小米手机时会遇到各种连接问题，下面先通过一张示意图了解整体流程。
问题排查前的准备工作
首先确认基础环境是否满足要求，避免因为基础配置问题导致连接失败。
- Mac上已经安装Android SDK，且ADB工具已添加到系统环境变量，可在终端执行
adb --version验证，正常会输出ADB版本信息 - 小米手机系统版本在Android 11及以上，支持无线调试功能
- Mac和小米手机处于同一个局域网，最好是连接同一个路由器，避免使用公共WiFi
小米手机端的必要设置
小米手机的MIUI系统有一些特殊设置，需要正确开启才能保证ADB无线连接正常。
开启开发者选项与无线调试
进入手机设置，找到关于手机，连续点击MIUI版本7次开启开发者选项，然后回到设置找到更多设置中的开发者选项，完成以下操作：
- 开启开发者选项开关
- 开启无线调试开关，点击进入无线调试页面，查看配对码和IP地址端口信息
- 关闭USB调试（可选，避免有线连接干扰，若后续需要有线调试可再开启）
- 部分MIUI版本需要开启USB调试（安全设置），允许通过USB调试修改权限或模拟点击
关闭MIUI优化（部分版本需要）
在开发者选项页面底部，找到MIUI优化选项，关闭该开关，重启手机后再次尝试连接，部分旧版本MIUI会因为该优化导致ADB连接异常。
Mac端的ADB连接操作
完成手机端设置后，在Mac终端执行对应的ADB命令完成连接。
配对连接（Android 11及以上）
无线调试页面会显示配对码和配对端口，先执行配对命令：
# 替换为手机上显示的配对端口，比如37211 adb pair 192.168.1.100:37211 # 执行后会提示输入配对码，输入手机上显示的6位配对码即可
配对成功后，再查看无线调试页面的IP和端口（注意不是配对端口，是连接端口，一般是5555或者其他端口）：
# 替换为手机上显示的连接IP和端口，比如192.168.1.100:5555 adb connect 192.168.1.100:5555
验证连接状态
执行以下命令查看已连接的设备：
adb devices
如果输出列表中出现对应的设备序列号，且状态为device，说明连接成功。
常见连接失败原因与解决方法
| 问题表现 | 可能原因 | 解决方法 |
|---|---|---|
| adb pair提示连接超时 | Mac和手机不在同一局域网，或者手机IP地址变化 | 确认两者连接同一WiFi，在手机无线调试页面重新查看最新IP地址，重新执行配对命令 |
| adb devices无设备显示 | ADB服务未启动或者被占用 | 执行adb kill-server关闭ADB服务，再执行adb start-server重启服务，重新连接 |
| 配对成功但connect失败 | 连接端口错误，使用了配对端口而非连接端口 | 在手机无线调试页面查看正确的连接端口，替换命令中的端口重新执行 |
| 提示无权限访问设备 | Mac未授权ADB调试权限 | 打开系统偏好设置中的安全性与隐私，在隐私标签页找到完全磁盘访问权限，将终端添加到权限列表，重启终端重试 |
| 连接后频繁断开 | WiFi信号不稳定，或者MIUI后台清理了无线调试进程 | 靠近路由器提升信号强度，在手机电池设置中将无线调试相关进程设置为不限制后台活动 |
其他注意事项
如果以上方法都无法解决问题，可以尝试以下操作：
- 升级小米手机系统到最新版本，部分旧版本MIUI的无线调试存在已知bug
- 升级Mac上的Android SDK到最新版本，确保ADB工具版本兼容
- 暂时关闭Mac的防火墙，部分防火墙规则会拦截ADB的端口通信
- 若需要长期使用无线调试，可以在手机上设置静态IP，避免IP变化导致每次都需要重新配对
注意：无线调试的配对信息在手机重启后会失效，重启后需要重新执行配对和连接操作，若需要持久化连接，可以查找ADB TCP模式相关的永久开启方法，但需要注意开放端口带来的安全风险，建议仅在开发环境使用。
按照以上步骤逐一排查，基本可以解决Mac上ADB无法连接小米手机无线调试的问题，顺利完成后续的开发调试工作。