如何在FirestoreRecycler中正确展示Firestore嵌套数据？

核心原因分析 #

空指针出现在List.get(int)，说明代码中某个List对象为null，大概率是Firestore映射POJO时未正确初始化嵌套List字段，或数据库结构与Model类不匹配导致List未被填充。

针对性解决方案 #

1. 确保Model类中嵌套List字段被初始化 #

Firestore映射POJO时不会自动为null的List字段创建空集合，需手动初始化避免空指针：

public class Building {
    private String name;
    // 初始化List为空集合，避免null
    private List<Room> rooms = new ArrayList<>();

    // 必须保留无参构造函数（Firestore反射实例化需要）
    public Building() {}

    // 带参构造中做null判断
    public Building(String name, List<Room> rooms) {
        this.name = name;
        this.rooms = rooms != null ? rooms : new ArrayList<>();
    }

    // getter/setter中同样做null防护
    public List<Room> getRooms() {
        return rooms;
    }

    public void setRooms(List<Room> rooms) {
        this.rooms = rooms != null ? rooms : new ArrayList<>();
    }
}

BuildingDocument类同理，内部嵌套的List字段也要提前初始化或在赋值时做null校验。

2. 校验数据库结构与Model类的映射匹配 #

• 字段名要与Firestore文档中的键完全一致（大小写敏感），若需自定义字段名，用@PropertyName注解指定：

  public class BuildingDocument {
      @PropertyName("building_title") // 对应数据库中的"building_title"键
      private String buildingTitle;
      private List<Building> buildings;
  
      // getter需同步加注解
      @PropertyName("building_title")
      public String getBuildingTitle() {
          return buildingTitle;
      }
  }
  

• 确认嵌套层级完全匹配：比如数据库中是buildings/{docId}/floors（数组类型），Model类对应字段必须是List<Floor>，不能用其他类型。

3. 修正FirestoreRecyclerOptions的查询配置 #

确保查询路径正确指向包含嵌套数据的集合，示例：

FirebaseFirestore db = FirebaseFirestore.getInstance();
// 正确指向你的目标集合，可按需添加排序/过滤条件
Query query = db.collection("buildings").orderBy("name");

FirestoreRecyclerOptions<BuildingDocument> options = new FirestoreRecyclerOptions.Builder<BuildingDocument>()
        .setQuery(query, BuildingDocument.class)
        .build();

4. Adapter绑定数据时增加空值判断 #

在onBindViewHolder中先判断List状态，再调用get(int)：

@Override
protected void onBindViewHolder(@NonNull BuildingViewHolder holder, int position, @NonNull BuildingDocument model) {
    List<Building> buildingList = model.getBuildings();
    // 先做非空非空集合判断
    if (buildingList != null && !buildingList.isEmpty()) {
        Building currentBuilding = buildingList.get(position);
        holder.tvName.setText(currentBuilding.getName());
        // 处理其他数据展示逻辑
    } else {
        // 显示空数据提示
        holder.tvName.setText("暂无建筑数据");
    }
}

5. 检查Firestore权限与数据有效性 #

确认数据库规则允许当前用户读取目标集合，同时检查目标文档中确实存在嵌套List数据（不是null或空数组）。

额外注意事项 #

• 所有Model类必须保留无参构造函数，Firestore依赖反射实例化对象。
• 若使用ProGuard，需添加规则避免Model类字段被混淆：

  -keep class com.yourpackage.models.** { *; }
  

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