Flutter集成Firebase时连接VM Service耗时超预期问题求助

问题现象 #

连接VM Service的耗时超出预期...
当前仍在尝试连接VM Service...
如果您未观察到Flutter应用处于运行状态，说明应用可能已发生崩溃，可查看设备日志（例如adb或XCode输出的日志）获取更多详细信息。
如果您可以看到Flutter应用已在设备上正常运行，可尝试添加--host-vmservice-port参数重新运行项目，指定一个已确认可用的端口。

已完成以下Firebase相关配置，但问题仍存在：

• main函数中添加初始化代码：

WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp();

• iOS端AppDelegate.swift中添加FirebaseApp.configure()代码
• 已将GoogleService-Info.plist文件添加到Runner目录

排查步骤 #

1. 确认应用启动状态，排查原生崩溃 #

• 手动点击设备/模拟器上的应用图标，确认是否能正常进入页面，是否存在闪退、卡在启动页的情况
• 若应用闪退：直接查看原生层错误日志，不要依赖Flutter调试输出
  • Android端执行adb logcat *:E过滤错误堆栈，重点排查Firebase初始化、Native崩溃相关日志
  • iOS端打开XCode连接设备，直接查看控制台输出，重点排查GoogleService-Info.plist加载失败、Firebase配置报错
  • 高频触发原因：GoogleService-Info.plist虽然被拖入Runner目录，但未勾选Target Membership下的Runner选项，导致安装包内未包含该配置文件，Firebase初始化时阻塞主线程，VM Service无法正常注册。解决方式：打开XCode选中GoogleService-Info.plist，在右侧File Inspector面板勾选Runner对应的Target选项即可。

2. 应用可正常打开但VM Service连接失败的排查 #

• 指定固定端口启动，避开端口占用问题，执行命令：
  flutter run --host-vmservice-port 9999 --dds-port 9998
• 关闭系统全局代理、VPN、抓包工具（Charles、Fiddler等），这类工具会拦截本地端口通信，导致VM Service连接失败
• iOS14+真机调试需检查本地网络权限：如果首次启动时拒绝了App的本地网络访问请求，会导致调试器无法和设备建立连接，前往系统设置-对应App的权限页，打开本地网络权限即可
• 清理构建缓存重试：执行flutter clean，手动删除ios/Pods目录、项目根目录下的build文件夹，依次执行flutter pub get、pod install（iOS端）后重新编译运行，旧构建缓存异常是这类问题的常见诱因。

3. Firebase初始化阻塞引擎的特殊处理 #

• 不要在main函数中直接await Firebase.initializeApp()阻塞引擎初始化流程，调整为异步初始化后再挂载根组件，参考代码：

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  Firebase.initializeApp().then((_) {
    runApp(const MyApp());
  });
}

• 检查iOS端AppDelegate.swift的代码调用顺序：FirebaseApp.configure()必须在GeneratedPluginRegistrant.register(with: self)之后调用，顺序颠倒会导致Firebase无法找到对应插件、卡死启动流程，正确写法参考：

import UIKit
import Flutter
import Firebase

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    GeneratedPluginRegistrant.register(with: self)
    FirebaseApp.configure()
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}

内容的提问来源于stack exchange，提问作者מירון יטבת