如何在Dart(Flutter)类中初始化异步变量？

你当前的写法存在核心问题：构造函数是同步执行的，调用init()后不会等待异步操作完成就直接返回MyClass实例，这会导致如果在wrapperObject初始化完成前调用类内依赖它的方法，必然触发LateInitializationError。下面是几种靠谱的解决方案：

方案一：异步工厂构造函数（推荐） #

用工厂构造函数返回Future<MyClass>，确保拿到实例时wrapperObject已经初始化完成：

class MyClass {
  final Wrapper wrapperObject;

  // 私有构造函数，禁止外部直接实例化
  MyClass._(this.wrapperObject);

  // 异步工厂构造函数，完成初始化后再返回实例
  factory MyClass() async {
    final wrapper = await Wrapper.createObject(...);
    return MyClass._(wrapper);
  }

  // 业务方法可以安全使用wrapperObject
  void doSomething() {
    wrapperObject.someMethod();
  }
}

使用方式：

// 必须用await获取实例
final myClass = await MyClass();

这种方式最直观，能从根源上避免未初始化的问题，代码逻辑清晰。

方案二：用Completer标记初始化状态 #

如果必须同步创建实例（比如某些框架要求），可以用Completer追踪初始化完成状态，在业务方法里先等待初始化完成：

class MyClass {
  late final Wrapper wrapperObject;
  final _initCompleter = Completer<bool>();

  MyClass() {
    _init();
  }

  Future<void> _init() async {
    wrapperObject = await Wrapper.createObject(...);
    _initCompleter.complete(true);
  }

  // 所有依赖wrapperObject的方法都要先等初始化完成
  Future<void> doSomething() async {
    await _initCompleter.future;
    wrapperObject.someMethod();
  }
}

这种方式可以同步创建实例，但每个业务方法都需要额外的异步等待，适合特定场景。

方案三：用AsyncMemoizer确保初始化只执行一次 #

如果担心初始化逻辑被多次触发，可以借助async包的AsyncMemoizer，保证初始化只运行一次：

import 'package:async/async.dart';

class MyClass {
  late final Wrapper wrapperObject;
  final _memoizer = AsyncMemoizer<void>();

  MyClass();

  Future<void> _init() => _memoizer.runOnce(() async {
        wrapperObject = await Wrapper.createObject(...);
      });

  Future<void> doSomething() async {
    await _init();
    wrapperObject.someMethod();
  }
}

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