如何解决Firebase子节点数据在Android RecyclerView中显示null问题

问题场景 #

当前Firebase Database结构如下，需要访问路径Retailer > Amritha Stores > r_history > 30-06-2022 > items > 0 > Khara Mixture下的子节点值。

应用的RecyclerView预期展示上述路径下的数据，但实际运行时所有字段均显示为null，运行效果如下：

数据模型设计参考：

核心错误原因 #

• 路径大小写不匹配：数据库中商品列表节点名为全小写items，代码中查询时写为大写开头的Items，路径指向不存在的节点，无法读取到有效数据。
• 查询层级错误：现有查询路径终止于items节点，该节点的直接子节点是数字索引（0、1、2...），数字索引节点下才是商品名节点（如Khara Mixture），商品名节点下才存储价格、数量等业务属性，查询路径比实际数据存储层级高两层，FirebaseUI无法自动映射到正确的属性值。
• 字段映射逻辑缺失：商品名称本身是商品属性节点的key（即Khara Mixture是节点名称），并不是节点下存储的name属性，原模型类直接读取name字段自然拿不到值。

修复方案 #

推荐方案：调整数据结构+修正查询路径 #

Firebase Realtime Database推荐使用扁平化数据结构，多余的嵌套层不仅会增加查询复杂度，还会提高数据维护成本。

1. 调整items节点下的存储结构，去掉多余的商品名嵌套层，每个数字索引节点直接存储商品全量属性，结构示例：

   Retailer/Amritha Stores/r_history/30-06-2022/items
   ├─0
   │  ├─name: "Khara Mixture"
   │  ├─price: "100"
   │  ├─quan: "2"
   │  ├─weight: "500g"
   │  └─total: "200"
   └─1
      ├─name: "其他商品名"
      └─...对应属性
   

2. 修正Fragment中的查询路径，把大写的Items改为小写的items，修正后代码：

   FirebaseRecyclerOptions<retailer_model_datewise_detailsdisp> options =
           new FirebaseRecyclerOptions.Builder<retailer_model_datewise_detailsdisp>()
                   .setQuery(FirebaseDatabase.getInstance().getReference()
                           .child("Retailer")
                           .child(username)
                           .child("r_history")
                           .child(datenew)
                           .child("items"),
                           retailer_model_datewise_detailsdisp.class)
                   .build();
   
   adapter=new adapter_retailerside_datewise_dispoforder(options);
   adapter.startListening();
   recyclerView.setAdapter(adapter);
   

3. 校验模型类字段类型：如果数据库中price、quan、total等字段存储为数字类型，需要把模型类中对应字段的类型从String改为匹配的数字类型（Long/Double），避免类型不匹配导致映射失败。

兼容方案：不修改存量数据的适配方法 #

如果暂时无法调整已存储的数据结构，就不能直接使用FirebaseRecyclerAdapter做自动映射，需要手动遍历数据层级组装模型，再通过普通RecyclerView适配器渲染：

1. 给items节点添加ValueEventListener监听数据变化
2. 逐层遍历items下的数字索引节点、商品名节点，把商品名节点的key作为商品名称，同时读取节点下的价格、数量等属性，组装为模型对象
3. 把组装完成的模型列表传入自定义普通适配器，调用刷新方法更新UI
   核心实现代码：

DatabaseReference itemsRef = FirebaseDatabase.getInstance().getReference()
        .child("Retailer").child(username).child("r_history").child(datenew).child("items");
itemsRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot snapshot) {
        List<retailer_model_datewise_detailsdisp> itemList = new ArrayList<>();
        // 遍历数字索引层
        for (DataSnapshot indexSnap : snapshot.getChildren()) {
            // 遍历商品名节点层
            for (DataSnapshot goodsSnap : indexSnap.getChildren()) {
                String goodsName = goodsSnap.getKey();
                String price = goodsSnap.child("Price").getValue(String.class);
                String quan = goodsSnap.child("Quan").getValue(String.class);
                String weight = goodsSnap.child("Weight").getValue(String.class);
                String total = goodsSnap.child("Total").getValue(String.class);
                itemList.add(new retailer_model_datewise_detailsdisp(goodsName, price, quan, weight, total));
            }
        }
        // 把itemList设置给你的普通RecyclerView适配器，调用notifyDataSetChanged刷新列表
    }

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        // 按需添加错误提示逻辑
    }
});

编码规范建议 #

• Java类名遵循大驼峰命名规则，例如将retailer_model_datewise_detailsdisp重命名为RetailerDatewiseDetail，适配器类重命名为RetailerOrderDatewiseAdapter，避免因代码混淆、大小写映射问题导致的异常错误。
• 数据存储时尽量保证同一字段的类型统一，不要混合存储字符串和数字，减少映射时的类型转换错误。

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