Flutter单例模式中如何让_internal方法支持异步操作？

因为Dart的构造函数不支持异步操作，所以没法在私有构造函数里直接await异步初始化方法。这里提供两种实用的解决思路：

方案1：通过静态异步方法获取已初始化的单例 #

将单例实例改为延迟初始化，通过静态方法完成异步初始化后再返回实例，确保拿到的实例已经完成Firebase的初始化工作。

class AppState {
  static late final AppState _instance;
  static bool _isInitialized = false;

  factory AppState() {
    if (!_isInitialized) {
      throw StateError("AppState未初始化，请先调用AppState.initialize()");
    }
    return _instance;
  }

  static Future<AppState> initialize() async {
    if (_isInitialized) return _instance;
    _instance = AppState._internal();
    await _instance._init();
    _isInitialized = true;
    return _instance;
  }

  late FirebaseApp app;
  late FirebaseDatabase appDb;

  Future<void> _init() async {
    app = await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    appDb = FirebaseDatabase.instanceFor(
      app: app,
      databaseURL: "https://moddeell122-rtdb.asia-southeast1.firebasedatabase.app/",
    );
  }

  AppState._internal();
}

使用方式：

// 应用启动阶段先执行初始化
final appState = await AppState.initialize();
// 后续任何地方都可以通过factory获取已初始化的实例
final sameInstance = AppState();

方案2：用Completer跟踪初始化状态 #

如果希望直接通过factory构造函数获取实例，但需要确保使用时初始化已完成，可以用Completer来追踪初始化状态：

class AppState {
  static final AppState _instance = AppState._internal();
  static final Completer<void> _initCompleter = Completer();

  factory AppState() {
    return _instance;
  }

  // 对外暴露的初始化等待方法
  static Future<void> ensureInitialized() => _initCompleter.future;

  late FirebaseApp app;
  late FirebaseDatabase appDb;

  AppState._internal() {
    // 构造函数中启动异步初始化，但不等待
    _init();
  }

  Future<void> _init() async {
    try {
      app = await Firebase.initializeApp(
        options: DefaultFirebaseOptions.currentPlatform,
      );
      appDb = FirebaseDatabase.instanceFor(
        app: app,
        databaseURL: "https://moddeell122-rtdb.asia-southeast1.firebasedatabase.app/",
      );
      // 初始化完成，标记完成状态
      _initCompleter.complete();
    } catch (e) {
      // 初始化失败，传递错误
      _initCompleter.completeError(e);
    }
  }
}

使用方式：

// 在使用AppState的任何操作前，先等待初始化完成
await AppState.ensureInitialized();
final appState = AppState();
// 此时app和appDb已完成初始化

关键提醒 #

• 绝对不要在构造函数中调用异步方法却不处理等待逻辑，这会导致late修饰的变量在未初始化时被访问，触发LateInitializationError。
• 方案1更偏向强制初始化顺序，避免误用未初始化的实例；方案2灵活性更高，但需要开发者主动确保在使用前等待初始化完成。

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