Android Studio中使用Flutter无法无线连接手机问题咨询

• 网络环境不兼容：手机与开发设备必须处于同一局域网，且确保两者连接的是WiFi的同一频段（避免2.4G与5G跨频段连接）；部分路由器开启双频隔离也会阻断设备间通信，可尝试关闭该功能。同时检查开发设备的防火墙、安全软件是否拦截了Flutter调试所需的端口。

• ADB无线调试未完成初始化：Flutter无线连接依赖ADB底层服务，需先确保手机开启「无线调试」（开发者选项内），并通过数据线完成首次配对：

  1. 连接数据线后执行 adb tcpip 5555
  2. 断开数据线，执行 adb connect [手机IP]:5555
     完成配对后再尝试扫码连接，部分场景下扫码流程需要基础的ADB无线连接作为前提。

• Flutter SDK版本存在bug：部分旧版Flutter的扫码无线连接功能存在兼容性问题，建议升级至最新稳定版（执行 flutter upgrade），或回退至已知可用的版本测试。

• 二维码解析或生成异常：扫码停滞可能是二维码包含的IP/端口信息有误。可跳过扫码，手动执行 flutter devices 查看是否能识别到无线设备，若能识别则直接用 flutter run -d [设备ID] 启动项目，以此排查是否为扫码环节的问题。

• 手机系统限制：部分品牌手机的安全隐私设置会阻止无线调试连接，需检查：

  • 是否开启「USB调试（安全设置）」（允许通过网络进行调试）
  • 是否允许调试应用获取网络权限
  • 安全管家类软件是否拦截了调试进程的网络请求

• 开发设备ADB服务异常：尝试重启ADB服务：执行 adb kill-server 后再执行 adb start-server；同时检查开发设备的IP是否为动态分配，若IP频繁变动会导致二维码失效，可设置静态IP后重新生成二维码。

内容的提问来源于stack exchange，提问作者Sarmad Munir