使用Stream与Firebase时出现DocumentSnapshotPlatform字段不存在错误如何解决

• 字段名不匹配：代码中读取doc['ownerId']、doc['id']两个字段，但Firestore对应文档中不存在该字段。常见两种场景：
  1. 存储任务时用户ID字段名是authorId（和查询条件一致），代码错误读取为ownerId
  2. 需要获取的是Firestore自动生成的文档ID，而非文档内部存储的id字段，直接用doc['id']无法读取到系统生成的文档ID
• 部分文档字段缺失：查询返回的文档列表中存在个别文档未写入对应字段，遍历到该文档时触发报错
• 集合指向错误：tasksRef指向的集合不符合预期，拉取到了非任务结构的文档

1. 先核对Firestore控制台中tasks集合的字段名，确保读取的字段名和实际存储一致
2. 增加安全取值逻辑，避免直接用[]读取字段，不存在时给默认值
3. 如果要读取系统生成的文档ID，替换doc['id']为doc.id
4. 建议用Model类序列化文档数据，避免手动读取字段的拼写错误

修复后代码示例 #

StreamBuilder<QuerySnapshot>(
  stream: DatabaseService.getFeedPosts(widget.currentUserId),
  builder: (context, snapshot) {
    if (snapshot.hasError) print(snapshot.error);
    if (snapshot.connectionState == ConnectionState.waiting) {
      return Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            CircularProgressIndicator(),
            Padding(padding: const EdgeInsets.only(top: 20.0)),
            Text('Finding tasks'),
          ],
        ),
      );
    }
    if (snapshot.hasData) {
      final documents = snapshot.data.docs;
      return ListView(
        children: documents
            .map(
              (doc) {
                final data = doc.data() as Map<String, dynamic>? ?? {};
                return TaskList(
                  currentUserId: widget.currentUserId,
                  // 读取系统文档ID用doc.id，如果是文档内存储的id字段则改为data['id'] ?? ''
                  task: doc.id,
                  // 字段名和实际存储保持一致，如果存储的是authorId则修改为data['authorId'] ?? ''
                  user: data['ownerId'] ?? '',
                );
              },
            )
            .toList());
    } else if (snapshot.hasError) {
      print('Error');
      return Text('It\'s Error!');
    }
    return Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: <Widget>[
          Text('Unable to  find any tasks'),
        ],
      ),
    );
  }),

可选优化：用Model类统一序列化 #

class Task {
  final String id;
  final String ownerId;

  Task({required this.id, required this.ownerId});

  factory Task.fromDocument(DocumentSnapshot doc) {
    final data = doc.data() as Map<String, dynamic>? ?? {};
    return Task(
      id: doc.id,
      ownerId: data['ownerId'] ?? data['authorId'] ?? '',
    );
  }
}

// 调用处直接转换
Task task = Task.fromDocument(doc);

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