Flutter Firebase Firestore：如何在单次调用中使用withConverter()？

直接在集合查询阶段绑定withConverter，配合limit(1)限制只获取首个文档，一次调用就能拿到转换后的实体，无需二次请求。核心代码如下：

// 替换为你的目标集合名称
final targetCollection = FirebaseFirestore.instance.collection('your_collection_name');

// 链式完成查询绑定转换器+限制结果数量
final querySnapshot = await targetCollection
    .withConverter<LatestStoredJobsEntity>(
      fromFirestore: (snapshot, _) => LatestStoredJobsEntity.fromFirestore(snapshot),
      toFirestore: (entity, _) => entity.toFirestore(),
    )
    .limit(1)
    .get();

// 处理查询结果
if (querySnapshot.docs.isNotEmpty) {
  // 直接拿到转换好的实体
  LatestStoredJobsEntity? jobsEntity = querySnapshot.docs[0].data();
  // 此处可直接使用jobsEntity
} else {
  // 集合为空时的处理逻辑
}

为什么之前的写法会需要二次请求？ #

你之前在querySnapshot.docs[0].reference上调用withConverter，得到的是带转换器的文档引用（WithConverterDocumentReference），这只是指向文档的指针，必须再调用get()才能发起请求获取文档快照（WithConverterDocumentSnapshot），所以会产生第二次调用。

而把withConverter绑定在集合查询上，整个查询的返回结果都会被自动转换，一次get()就能拿到包含转换后实体的QueryDocumentSnapshot，直接调用data()就能拿到目标实体。

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