Flutter中Firestore QuerySnapshot仅返回首个文档问题求助

你的问题出在返回结果的处理方式上：

• value.docs是符合条件的文档快照列表，直接强制转成Map会导致类型错误，返回的是快照实例而非实际数据
• value.docs.first.data()仅提取了列表里的第一个文档，自然无法获取全部结果

修正后的代码 #

修改fetchData函数的返回类型，并遍历所有文档提取数据：

Future<List<Map<String, dynamic>>> fetchData() async {
  var querySnapshot = await FirebaseFirestore.instance
      .collection('seller')
      .where('typeOfItem', isEqualTo: 'Kuku broiler')
      .where('timeAdded', isGreaterThan: DateTime.now().subtract(const Duration(days: 1)))
      .get();

  // 遍历所有文档快照，提取每个文档的键值对数据并组成列表
  return querySnapshot.docs.map((doc) => doc.data()).toList();
}

后续在FutureBuilder中的使用 #

拿到完整数据列表后，可在FutureBuilder中遍历展示所有内容：

FutureBuilder<List<Map<String, dynamic>>>(
  future: fetchData(),
  builder: (context, snapshot) {
    if (snapshot.hasData) {
      return ListView.builder(
        itemCount: snapshot.data!.length,
        itemBuilder: (context, index) {
          var sellerData = snapshot.data![index];
          // 根据实际字段渲染UI
          return ListTile(
            title: Text(sellerData['typeOfItem']),
            subtitle: Text(sellerData['timeAdded'].toString()),
          );
        },
      );
    } else if (snapshot.hasError) {
      return Text('加载出错: ${snapshot.error}');
    }
    // 加载中状态
    return const CircularProgressIndicator();
  },
)

关键说明 #

• querySnapshot.docs返回List<QueryDocumentSnapshot>类型，每个元素是单个文档的快照对象
• 调用doc.data()可获取该文档的实际键值对数据（Map类型）
• 通过map遍历所有快照完成数据转换，最后用toList()生成可返回的列表

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