如何在Flutter中正确获取Firebase嵌套数据？

背景 #

跟随Firebase CRUD教程修改了笔记保存代码，具体实现如下：

Future<void> addNewNote(String noteheader, String noteContent) {
  return notes.add({
    'note': {
      'header': noteHeader,
      'content': noteContent,
    },
    'timestamp': Timestamp.now()
  });
}

数据存储结构 #

笔记在Firestore中的存储结构如下：

当前尝试的代码 #

尝试用StreamBuilder获取数据，但无法正确读取嵌套的header和content字段：

body: StreamBuilder<QuerySnapshot>(
  stream: firestoreService.getNotesStream(),
  builder: (context, snapshot) {
    if (snapshot.hasData) {
      List notesList = snapshot.data!.docs;
      return ListView.builder(
        itemCount: notesList.length,
        itemBuilder: (context, index) {
          DocumentSnapshot document = notesList[index];
          String docId = document.id;
          Map<String, dynamic> data = document.data() as Map<String, dynamic>;
          String noteHeader = data['note']; // 此处逻辑错误
          return ListTile(
            title: Text(noteHeader),
          );
        });
    } else {
      return const Text('No Notes');
    }
  },
)

解决方案 #

问题核心是data['note']并非String类型，而是嵌套的Map对象。需先将其转换为Map，再提取内部字段。修改后的代码片段如下：

itemBuilder: (context, index) {
  DocumentSnapshot document = notesList[index];
  String docId = document.id;
  Map<String, dynamic> data = document.data() as Map<String, dynamic>;
  
  // 提取嵌套的note子Map
  Map<String, dynamic> noteData = data['note'] as Map<String, dynamic>;
  String noteHeader = noteData['header'];
  String noteContent = noteData['content'];
  
  return ListTile(
    title: Text(noteHeader),
    subtitle: Text(noteContent), // 可选：同时展示笔记内容
  );
}

关键说明 #

• data['note']返回的是包含header和content的子级Map，必须先转换为Map<String, dynamic>类型才能访问内部字段
• 转换完成后，直接通过noteData['header']和noteData['content']即可获取对应嵌套字段的值

内容的提问来源于stack exchange，提问作者Muhammadim Yusoff Jamaluddin