Flutter+Firebase如何获取Firestore文档中reference字段关联数据

Cloud Firestore的Reference类型字段仅存储关联文档的路径指针，查询主集合时不会自动关联拉取引用指向的文档内容，直接读取只能得到DocumentReference类型对象，必须主动调用该对象的查询方法才能获取实际存储的业务数据。

拿到引用字段返回的DocumentReference对象后：

• 一次性拉取数据调用.get()方法
• 需要实时监听关联文档变更调用.snapshots()方法
  如果单个主文档关联多个引用（如存储引用数组），遍历所有DocumentReference对象逐个拉取后汇总结果即可。

以下是修改后的可运行代码，通过FutureBuilder并行拉取关联的idType、area字段数据，不阻塞列表整体加载：

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:flutter/material.dart';

class HomePage extends StatefulWidget {
  const HomePage({Key? key}) : super(key: key);

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  final clientsCollection = FirebaseFirestore.instance.collection('clients');

  @override
  Widget build(BuildContext context) {
    return StreamBuilder<QuerySnapshot>(
      stream: clientsCollection.orderBy('name').snapshots(),
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const Center(child: CircularProgressIndicator());
        } else if (snapshot.hasError) {
          return const Center(child: Text('加载出错'));
        } else if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
          return const Center(child: Text('暂无数据'));
        }

        return Scrollbar(
          child: ListView.builder(
            physics: const BouncingScrollPhysics(),
            itemCount: snapshot.data!.docs.length,
            itemBuilder: (BuildContext context, int index) {
              final clientDoc = snapshot.data!.docs[index];
              // 读取两个引用类型字段
              final DocumentReference? idTypeRef = clientDoc['idType'];
              final DocumentReference? areaRef = clientDoc['area'];

              // 空引用兜底
              if (idTypeRef == null || areaRef == null) {
                return const ListTile(title: Text('关联数据缺失'));
              }

              // 并行拉取两个关联文档的数据
              return FutureBuilder(
                future: Future.wait([
                  idTypeRef.get(),
                  areaRef.get(),
                ]),
                builder: (context, asyncSnapshot) {
                  if (asyncSnapshot.connectionState == ConnectionState.waiting) {
                    return const ListTile(title: Text('加载中...'));
                  }
                  if (asyncSnapshot.hasError) {
                    return const ListTile(title: Text('关联数据加载失败'));
                  }

                  // 解析关联文档的实际业务数据
                  final idTypeDoc = asyncSnapshot.data![0];
                  final areaDoc = asyncSnapshot.data![1];
                  final idTypeData = idTypeDoc.data() as Map<String, dynamic>;
                  final areaData = areaDoc.data() as Map<String, dynamic>;

                  // 调试输出
                  print('客户名称: ${clientDoc['name']}');
                  print('客户ID: ${clientDoc['id']}');
                  print('证件类型: ${idTypeData['name']}'); // 替换为idType集合中实际存储的字段名
                  print('所属区域: ${areaData['name']}'); // 替换为areas集合中实际存储的字段名

                  return ListTile(
                    title: Text(clientDoc['name']),
                    subtitle: Text('证件类型：${idTypeData['name']} | 所属区域：${areaData['name']}'),
                  );
                },
              );
            },
          ),
        );
      },
    );
  }
}

• 若需要关联数据和主集合数据保持实时同步，可将列表项的FutureBuilder替换为StreamBuilder，通过流组合方法（如combineLatest）同时监听主文档和关联引用的变更即可。
• 若单个主文档关联的引用字段较多，建议增加本地缓存逻辑，避免列表滚动时重复发起请求增加读取成本。
• 读取引用字段前建议先做非空判断，避免字段未赋值时调用get/snapshots方法抛出空指针异常。

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