Flutter访问Firestore报错：_MapStream不是Stream<DocumentSnapshot?>子类型

错误根因 #

你调用 .collection('details').snapshots() 返回的是Stream<QuerySnapshot>类型（对应集合下所有文档的快照流），但StreamBuilder指定的快照类型是AsyncSnapshot<DocumentSnapshot>（对应单份文档的快照流），二者类型不匹配触发转换报错。

修复方案 #

方案1：读取details集合下指定单份文档的plan字段 #

如果你只需要取单条文档的字段，在查询时指定具体的文档ID即可：

1. 显式声明_fireS的类型，提前规避编译期类型问题：

class _userState extends State<user> {
  // 替换原来的late final _fireS;
  late final Stream<DocumentSnapshot<Map<String, dynamic>>> _fireS;
  String id = FirebaseAuth.instance.currentUser!.uid;

2. 修改initState里的查询逻辑，补充文档ID：

@override
void initState() {
  super.initState();
  _fireS = FirebaseFirestore.instance
      .collection('user')
      .doc(id)
      .collection('details')
      .doc('目标文档ID') // 替换为你的实际文档ID
      .snapshots();
}

3. 修改StreamBuilder的泛型匹配返回类型：

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: StreamBuilder<DocumentSnapshot<Map<String, dynamic>>>(
      stream: _fireS,
      builder: (BuildContext context, snapshot) {
        if (snapshot.hasError) return const Text('加载出错');
        if (snapshot.connectionState == ConnectionState.waiting) return const CircularProgressIndicator();
        if (!snapshot.hasData) return const Text('暂无数据');
        
        Map<String, dynamic> data = snapshot.data!.data()!;
        var userPlan = data['plan'];
        return Text(userPlan.toString());
      },
    ),
  );
}

方案2：读取details集合下所有文档的plan字段 #

如果你需要遍历整个details集合的所有文档取值，修改StreamBuilder的泛型匹配QuerySnapshot即可：

1. 显式声明_fireS类型：

class _userState extends State<user> {
  // 替换原来的late final _fireS;
  late final Stream<QuerySnapshot<Map<String, dynamic>>> _fireS;
  String id = FirebaseAuth.instance.currentUser!.uid;

2. initState逻辑保持不变，修改StreamBuilder部分代码：

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: StreamBuilder<QuerySnapshot<Map<String, dynamic>>>(
      stream: _fireS,
      builder: (BuildContext context, snapshot) {
        if (snapshot.hasError) return const Text('加载出错');
        if (snapshot.connectionState == ConnectionState.waiting) return const CircularProgressIndicator();
        if (!snapshot.hasData) return const Text('暂无数据');
        
        // 遍历所有文档取出plan字段展示
        return Column(
          children: snapshot.data!.docs.map((doc) {
            var userPlan = doc.data()['plan'];
            return Text(userPlan.toString());
          }).toList(),
        );
      },
    ),
  );
}

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