Flutter获取Firestore集合时.then回调未触发 列表无法加载数据

• 惰性迭代器未执行：.then回调中使用的snapshot.docs.map()会返回惰性Iterable对象，如果不调用.toList()、.forEach()等方法主动消费这个迭代器，传入map的逻辑（打印日志、往ids塞数据）根本不会运行，这就是你观测到数据已经返回但回调逻辑不触发的直接原因。
• 组件状态持有错误：在StatelessWidget（无状态组件）内定义可变成员变量ids不符合Flutter组件规则，每次组件重绘时这个列表都会被重置为空，就算拿到数据也存不住。
• FutureBuilder用法错误：_getPlayers方法声明返回void，没有把加载到的数据返回给FutureBuilder；builder回调完全没有判断snapshot的加载/错误状态，也没有读取snapshot持有的异步结果，直接依赖外部的ids变量，就算数据加载完成也不会触发UI刷新。
• 异步写法不规范：无意义混用async/await和.then两种异步写法，容易干扰执行顺序判断。

按照FutureBuilder的标准用法改造，让异步方法直接返回加载到的id列表，不依赖外部可变变量，同时补上加载状态、错误状态的判断，修复后的完整代码如下：

import 'package:flutter/material.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

class InviteView extends StatelessWidget {
  InviteView({Key? key}) : super(key: key);

  Future<List<String>> _getPlayers() async {
    const source = Source.server;
    final querySnapshot = await FirebaseFirestore.instance
        .collection('players')
        .get(const GetOptions(source: source));
    // 主动调用toList()消费map的结果，转换为id列表返回
    return querySnapshot.docs.map((doc) => doc.reference.id).toList();
  }

  @override
  Widget build(BuildContext context) {
    return Expanded(
      child: FutureBuilder<List<String>>(
        future: _getPlayers(),
        builder: (context, snapshot) {
          // 加载中状态
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }
          // 加载错误状态
          if (snapshot.hasError) {
            return Center(child: Text('数据加载失败: ${snapshot.error}'));
          }
          // 拿到有效数据渲染列表
          final idList = snapshot.data ?? [];
          return ListView.builder(
            itemCount: idList.length,
            itemBuilder: (ctx, index) {
              return ListTile(
                title: Text(idList[index]),
              );
            },
          );
        },
      ),
    );
  }
}

补充说明 #

• 如果坚持使用.then写法，必须主动消费迭代器，两种正确写法示例：

  // 写法1：map后转list触发执行
  await FirebaseFirestore.instance.collection('players').get(const GetOptions(source: source)).then(
    (snapshot) {
      ids = snapshot.docs.map((doc) => doc.reference.id).toList();
    },
    onError: (e) => print(e.toString())
  );
  
  // 写法2：直接用forEach遍历，不存在惰性问题
  await FirebaseFirestore.instance.collection('players').get(const GetOptions(source: source)).then(
    (snapshot) {
      snapshot.docs.forEach((doc) {
        print(doc.reference.id);
        ids.add(doc.reference.id);
      });
    },
    onError: (e) => print(e.toString())
  );
  

• flutter doctor输出中Visual Studio未安装的报错不影响安卓、Web端调试，只有开发Windows桌面应用时才需要依赖该组件，可以直接忽略。
• 你使用的cloud_firestore: ^3.1.17版本和Flutter 3.0.1稳定版完全兼容，不存在版本适配问题。

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