Flutter切换Firestore集合StreamBuilder时出现快照串扰触发字段不存在报错

问题原因 #

这个报错的核心原因是Flutter Widget的状态复用机制：你在同一位置动态切换两个StreamBuilder时，没有给它们指定唯一标识Key，Flutter默认会把它们识别为同一个Widget，只会更新属性而不会销毁重建旧的StreamBuilder，因此旧的集合快照状态被保留下来，才会出现拿到另一个集合数据的情况。

解决方案 #

1. 给StreamBuilder添加唯一Key（最快修复） #

只需要给不同集合的StreamBuilder传入不同的ValueKey，强制Flutter切换时销毁旧组件、重建新组件，就不会复用旧的快照数据：
首先修改_buildList方法的定义，接收Key参数：

// 新增key参数
Widget _buildList(String collectionName, {Key? key}) {
  return StreamBuilder<QuerySnapshot>(
    key: key, // 把key传给StreamBuilder
    stream: FirebaseFirestore.instance.collection(collectionName).snapshots(),
    // 其余原有代码保持不变
    builder: (context, snapshot) {
      // 原有逻辑不变...
    }
  );
}

然后调用的时候传入对应唯一Key：

Obx(
  () => Container(
    child: _controller.currentStream.value == 0
        ? _buildList('stream1', key: const ValueKey('stream1'))
        : _buildList('stream2', key: const ValueKey('stream2')),
  ),
)

2. 增加字段存在性校验（可选，增强鲁棒性） #

即使后续有其他异常场景，也可以提前判断字段是否存在，避免直接抛出崩溃：

// 读取stream1字段的写法
final docData = snapshot.data!.docs[index].data() as Map<String, dynamic>;
return ListTile(
  title: Text(docData.containsKey('1') ? docData['1'].toString() : '无数据'),
);
// stream2同理换成判断key为'a'即可

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