如何用FirebaseRecyclerAdapter获取子节点中的所有月份名称列表？

我之前也遇到过类似的坑，咱们一步步来排查和实现，先从最核心的FirebaseRecyclerAdapter方案说起，再补充手动监听的备选方案，同时帮你排查空列表的常见原因。

第一步：先明确你的Firebase数据结构 #

首先得确认你的数据库节点结构，两种常见情况对应不同的实现：

情况1：直接存储月份字符串（键值对） #

months
  |--- 0: "January"
  |--- 1: "February"
  |--- 2: "March"
  ...

情况2：每个月份是独立节点，包含name字段 #

months
  |--- month1
       |--- name: "January"
  |--- month2
       |--- name: "February"
  ...

第二步：用FirebaseRecyclerAdapter实现列表 #

1. 添加依赖（确保版本和你的Firebase SDK匹配） #

在Module级别的build.gradle里添加FirebaseUI依赖：

implementation 'com.firebaseui:firebase-ui-database:8.0.0'

2. 创建实体类（针对情况2） #

如果是情况1可以跳过实体类，直接用String类型：

public class Month {
    private String name;

    // 必须保留无参构造函数！Firebase反序列化需要
    public Month() {}

    public Month(String name) {
        this.name = name;
    }

    // Getter和Setter必须有，否则Firebase无法映射字段
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

3. 编写列表Item布局（item_month.xml） #

<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/tv_month_name"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp"
    android:textSize="18sp"/>

4. 在Activity/Fragment中初始化列表和适配器 #

针对情况1（直接存储字符串）：

// 初始化RecyclerView
RecyclerView recyclerView = findViewById(R.id.recycler_view_months);
recyclerView.setLayoutManager(new LinearLayoutManager(this));

// 获取Firebase数据库引用，路径一定要和你的节点完全匹配！
DatabaseReference monthsRef = FirebaseDatabase.getInstance().getReference("months");

// 配置FirebaseRecyclerOptions
FirebaseRecyclerOptions<String> options =
        new FirebaseRecyclerOptions.Builder<String>()
                .setQuery(monthsRef, String.class)
                .build();

// 创建适配器
FirebaseRecyclerAdapter<String, MonthViewHolder> adapter =
        new FirebaseRecyclerAdapter<String, MonthViewHolder>(options) {
            @Override
            protected void onBindViewHolder(@NonNull MonthViewHolder holder, int position, @NonNull String monthName) {
                // 绑定数据到Item
                holder.monthNameTv.setText(monthName);
            }

            @NonNull
            @Override
            public MonthViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
                View itemView = LayoutInflater.from(parent.getContext())
                        .inflate(R.layout.item_month, parent, false);
                return new MonthViewHolder(itemView);
            }
        };

// 设置适配器
recyclerView.setAdapter(adapter);

// 关键！必须调用startListening才会开始加载数据
adapter.startListening();

// 在页面销毁时停止监听，避免内存泄漏
@Override
protected void onStop() {
    super.onStop();
    if (adapter != null) {
        adapter.stopListening();
    }
}

// ViewHolder内部类
static class MonthViewHolder extends RecyclerView.ViewHolder {
    TextView monthNameTv;

    public MonthViewHolder(@NonNull View itemView) {
        super(itemView);
        monthNameTv = itemView.findViewById(R.id.tv_month_name);
    }
}

针对情况2（带name字段的节点）：

只需要修改FirebaseRecyclerOptions和适配器的泛型：

FirebaseRecyclerOptions<Month> options =
        new FirebaseRecyclerOptions.Builder<Month>()
                .setQuery(monthsRef, Month.class)
                .build();

FirebaseRecyclerAdapter<Month, MonthViewHolder> adapter =
        new FirebaseRecyclerAdapter<Month, MonthViewHolder>(options) {
            @Override
            protected void onBindViewHolder(@NonNull MonthViewHolder holder, int position, @NonNull Month month) {
                holder.monthNameTv.setText(month.getName());
            }

            // onCreateViewHolder和之前一致
        };

第三步：排查空列表的常见原因 #

如果还是空列表，按顺序检查这几点：

• 数据库路径错误：确认monthsRef的路径和Firebase控制台的节点完全一致，比如节点是year/2024/months就不能只写months。
• 安全规则限制：默认的Firebase规则要求用户认证后才能读写，如果你没登录，会被拒绝访问。可以临时改成测试规则（上线前一定要改回来）：

  {
    "rules": {
      ".read": true,
      ".write": true
    }
  }
  

• 忘记调用startListening()：这是最容易踩的坑，FirebaseRecyclerAdapter必须调用这个方法才会开始监听数据。
• 实体类不符合要求：必须有无参构造函数，字段名称和数据库完全匹配（大小写敏感），Getter/Setter不能少。
• 数据类型不匹配：比如数据库存的是数字，你用String接收，会导致解析失败。

备选方案：用ValueEventListener手动加载数据 #

如果不想用FirebaseRecyclerAdapter，也可以手动监听数据并加载到普通RecyclerView：

monthsRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot snapshot) {
        List<String> monthList = new ArrayList<>();
        for (DataSnapshot monthSnap : snapshot.getChildren()) {
            // 情况1：直接取字符串
            String name = monthSnap.getValue(String.class);
            // 情况2：取子节点的值
            // String name = monthSnap.child("name").getValue(String.class);
            monthList.add(name);
        }
        // 用普通RecyclerView适配器加载列表
        MyNormalAdapter adapter = new MyNormalAdapter(monthList);
        recyclerView.setAdapter(adapter);
    }

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        Toast.makeText(MainActivity.this, "加载失败：" + error.getMessage(), Toast.LENGTH_SHORT).show();
    }
});

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