如何使用异步方法返回值初始化Widget的State类中的字段？

问题原因 #

你无法直接在类实例变量初始化阶段使用await的核心原因是：await仅能在标记为async的函数内部使用，而Dart的类成员初始化过程不支持异步上下文，也无法将整个类标记为async。

可选解决方案 #

方案1：initState 结合异步回调/异步函数 #

这是最基础的实现方式，适合拿到数据后需要执行额外业务逻辑的场景：

class _MyHomePageState extends State<MyHomePage> {
  final itemDao = ItemDao();
  // 先声明为可空类型，待异步请求完成后赋值
  List<Item>? _list;

  @override
  void initState() {
    super.initState();
    _initItemList();
  }

  Future<void> _initItemList() async {
    final items = await itemDao.getAllItems();
    // 赋值后调用setState更新UI
    setState(() {
      _list = items;
    });
  }

  @override
  Widget build(BuildContext context) {
    // 渲染时先判断_list是否已赋值，未赋值可展示加载占位
    if (_list == null) {
      return const CircularProgressIndicator();
    }
    // 拿到数据后的渲染逻辑
    return ListView.builder(
      itemCount: _list!.length,
      // 其余渲染逻辑
    );
  }
}

方案2：使用FutureBuilder #

Flutter内置的FutureBuilder组件天然适配异步数据渲染场景，会自动处理加载、错误、成功三种状态，不需要手动管理setState和空判断：

class _MyHomePageState extends State<MyHomePage> {
  final itemDao = ItemDao();
  // 声明Future类型变量存储异步请求
  late Future<List<Item>> _itemsFuture;

  @override
  void initState() {
    super.initState();
    // 仅在initState中初始化一次Future，避免build重绘时重复触发请求
    _itemsFuture = itemDao.getAllItems();
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<List<Item>>(
      future: _itemsFuture,
      builder: (context, snapshot) {
        // 加载中状态
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const Center(child: CircularProgressIndicator());
        }
        // 错误状态
        if (snapshot.hasError) {
          return Center(child: Text('加载失败：${snapshot.error}'));
        }
        // 加载成功，取数据渲染
        final items = snapshot.data!;
        return ListView.builder(
          itemCount: items.length,
          itemBuilder: (context, index) => ListTile(title: Text(items[index].name)),
        );
      },
    );
  }
}

方案选择建议 #

• 优先选择FutureBuilder：如果仅需要根据异步返回结果渲染UI，没有额外的状态处理逻辑，该方案代码更简洁、状态处理更完善
• 选择initState方案：如果拿到数据后需要执行额外的业务操作（比如数据过滤、更新其他关联状态变量、埋点上报等），该方案灵活性更高

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