Flutter无线调试时App卡在启动页问题求助

环境信息 #

• Flutter版本：3.16.9
• 开发工具：VSCode（安装最新版Flutter扩展）
• 调试设备：iPhone（已在Xcode中配置无线连接）

问题描述 #

在VSCode中点击无线调试按钮时，App停留在启动页无法进入主页面，有线调试完全正常，怀疑无法连接Dart VM；终端运行flutter run时App可正常启动，但无法对修改后的代码执行热重载。
已尝试的排查操作：

• 重启Mac
• 重装VSCode的Flutter扩展
• 开关iPhone开发者设置
• 确保iPhone与Mac处于同一网络，尝试过iPhone个人热点连接
• 已允许App访问本地网络

可能的解决方案 #

1. 手动指定Dart VM固定端口 #

在VSCode的launch.json中添加端口配置，避免自动分配端口时的网络连通问题：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Flutter",
      "request": "launch",
      "type": "dart",
      "dartVmServicePort": 8181 // 指定固定端口，确保Mac和iPhone能互通
    }
  ]
}

修改后重启无线调试，同时确认Mac防火墙未阻止该端口的入站连接。

2. 重置Flutter设备连接缓存 #

在终端执行以下命令，清除设备连接相关缓存：

flutter clean
flutter pub get
flutter devices

完成后重新在VSCode中选择无线设备启动调试。

3. 重新配对Xcode无线调试 #

打开Xcode，进入Window > Devices and Simulators，找到目标iPhone设备：

• 右键选择Show run destinations menu，确认无线连接状态为已配对且在线
• 若状态异常，先移除配对，再重新通过Xcode建立无线连接

4. 终端启动调试后VSCode附加进程 #

在终端手动指定端口启动调试，再让VSCode附加到该进程：

flutter run --host-vmservice-port 8181 --web-hostname 0.0.0.0

启动后，在VSCode调试面板选择Attach to Running App，输入端口8181，尝试调试和热重载。

5. 重置Flutter全局配置 #

执行命令重置Flutter所有配置，排除异常配置影响：

flutter config --reset

重置后重新安装依赖并测试无线调试。

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