Firestore查询根集合文档时如何同步获取子集合Photos数据并展示到RecyclerView

问题根因 #

Firestore 的查询为浅查询，仅返回当前目标集合/查询路径下的文档数据，不会自动递归拉取子集合内容，你当前的查询仅针对 Product 根集合，自然无法直接拿到对应文档下的 Photos 子集合数据。

具体实现步骤 #

• 第一步：查询获取匹配的 Product 文档
  首先修正原有查询逻辑，先拿到符合条件的 Product 文档实例：

// 原有查询参数错误，第一个参数应为Product文档内的字段名，而非集合名
Query productQuery = db.collection("Product").whereEqualTo("product name", Constants.PRODUCT_NAME);
productQuery.get().addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        for (QueryDocumentSnapshot document : task.getResult()) {
            // 拿到匹配的Product文档引用
            DocumentReference productRef = document.getReference();
            // 解析Product基础数据存入自定义实体类
            Product product = document.toObject(Product.class);
            // 拉取该文档下的Photos子集合
            loadPhotosSubCollection(productRef, product);
        }
    }
});

• 第二步：拉取对应 Product 文档下的 Photos 子集合

private void loadPhotosSubCollection(DocumentReference productRef, Product product) {
    productRef.collection("Photos").get().addOnCompleteListener(photoTask -> {
        if (photoTask.isSuccessful()) {
            List<String> imageUrls = new ArrayList<>();
            for (QueryDocumentSnapshot photoDoc : photoTask.getResult()) {
                String url = photoDoc.getString("image_url");
                imageUrls.add(url);
            }
            // 将图片列表存入Product实体类（需提前在实体类中添加List<String>类型的imageUrls字段）
            product.setImageUrls(imageUrls);
            // 存入列表后刷新RecyclerView
            productList.add(product);
            adapter.notifyDataSetChanged();
        }
    });
}

• 第三步：适配 RecyclerView 数据
  FirestoreRecyclerAdapter 本身仅支持绑定单查询结果，你需要改用普通的 RecyclerView.Adapter，或者自定义扩展 FirestoreRecyclerAdapter，在拿到每个 Product 文档后异步拉取子集合数据，再更新对应 item 的 UI 即可。

注意事项 #

• 你原有查询的字段参数错误：whereEqualTo("Product", Constants.PRODUCT_NAME) 中的第一个参数应该是 Product 文档内的字段名 product name，而非集合名 Product，这也是你可能查询结果不符合预期的原因之一。
• 如果需要实时监听数据变化，可以分别给 Product 集合和对应的 Photos 子集合添加 SnapshotListener，子集合数据更新后手动刷新对应列表项即可。

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