Firestore数据无法在RecyclerView中显示的问题排查与解决

一、布局嵌套与RecyclerView高度问题 #

原布局中RecyclerView被包裹在ScrollView内，且RecyclerView的android:layout_height="match_parent"，这会导致RecyclerView无法正确计算自身高度，从而无法显示列表项。

解决方案：

1. 移除外层ScrollView（推荐），因为RecyclerView自带滚动功能，无需额外嵌套：

<!-- 修改后的appointment_history.xml根布局 -->
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".Appointment_History">

    <!-- 原有其他控件保持不变 -->

    <androidx.recyclerview.widget.RecyclerView
        android:id = "@+id/appointment_recyclerview"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_marginTop="130dp"
        android:layout_marginBottom="80dp"
        app:layout_constraintBottom_toTopOf="@+id/button_appointment_history"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

2. 若必须保留滚动容器，改用NestedScrollView并禁用RecyclerView嵌套滚动：
   在setUpRecyclerView方法中添加：

recyclerView.setNestedScrollingEnabled(false);

二、Model类字段映射不完整问题 #

Firestore需要通过setter方法或公开字段完成数据映射，原Model类仅提供getter方法，缺少setter会导致数据无法正确解析。同时需确保@PropertyName注解与Firestore字段名完全匹配（包括大小写）。

解决方案：
为Appointment类添加所有字段的setter方法：

import com.google.firebase.firestore.PropertyName;

public class Appointment {
    private String Age;
    private String Date;
    private String Height;
    private String Queue;
    private String Weight;
    private String clinic_id;
    private String clinic_treatment;
    private String doctor_id;
    private String symptom_description;
    private String user_id;

    public Appointment(){}

    public Appointment(String age, String date, String height, String queue, String weight, String clinic_id, String clinic_treatment, String doctor_id, String symptom_description, String user_id){
        this.Age = age;
        this.Date = date;
        this.Height = height;
        this.Queue = queue;
        this.Weight = weight;
        this.clinic_id = clinic_id;
        this.clinic_treatment = clinic_treatment;
        this.doctor_id = doctor_id;
        this.symptom_description = symptom_description;
        this.user_id = user_id;
    }

    @PropertyName("Age")
    public String getAge() { return Age; }

    @PropertyName("Age")
    public void setAge(String age) { Age = age; }

    @PropertyName("Date")
    public String getDate() { return Date; }

    @PropertyName("Date")
    public void setDate(String date) { Date = date; }

    @PropertyName("Height")
    public String getHeight() { return Height; }

    @PropertyName("Height")
    public void setHeight(String height) { Height = height; }

    @PropertyName("Queue")
    public String getQueue() { return Queue; }

    @PropertyName("Queue")
    public void setQueue(String queue) { Queue = queue; }

    @PropertyName("Weight")
    public String getWeight() { return Weight; }

    @PropertyName("Weight")
    public void setWeight(String weight) { Weight = weight; }

    @PropertyName("clinic_id")
    public String getClinic_id() { return clinic_id; }

    @PropertyName("clinic_id")
    public void setClinic_id(String clinic_id) { this.clinic_id = clinic_id; }

    @PropertyName("clinic_treatment")
    public String getClinic_treatment() { return clinic_treatment; }

    @PropertyName("clinic_treatment")
    public void setClinic_treatment(String clinic_treatment) { this.clinic_treatment = clinic_treatment; }

    @PropertyName("doctor_id")
    public String getDoctor_id() { return doctor_id; }

    @PropertyName("doctor_id")
    public void setDoctor_id(String doctor_id) { this.doctor_id = doctor_id; }

    @PropertyName("symptom_description")
    public String getSymptom_description() { return symptom_description; }

    @PropertyName("symptom_description")
    public void setSymptom_description(String symptom_description) { this.symptom_description = symptom_description; }

    @PropertyName("user_id")
    public String getUser_id() { return user_id; }

    @PropertyName("user_id")
    public void setUser_id(String user_id) { this.user_id = user_id; }

    public String getDate_Queue(){return getDate() + " " + getQueue();}
}

三、查询结果验证问题 #

需确认查询条件是否正确，以及Firestore中是否存在匹配数据。可添加快照监听器打印查询结果，排查数据返回情况。

解决方案：
在setUpRecyclerView方法中添加查询快照监听：

private void setUpRecyclerView(String uID){
    FirebaseFirestore db = FirebaseFirestore.getInstance();

    Query query = db.collection("Appointment").whereEqualTo("user_id",uID);

    // 添加快照监听验证数据
    query.addSnapshotListener((value, error) -> {
        if (error != null) {
            Log.e("FirestoreError", error.getMessage());
            return;
        }
        if (value != null && !value.isEmpty()) {
            Log.d("FirestoreData", "查询到" + value.size() + "条数据");
            for (var doc : value.getDocuments()) {
                Log.d("FirestoreDoc", doc.getData().toString());
            }
        } else {
            Log.d("FirestoreData", "未查询到数据");
        }
    });

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

    adapter = new Adapter(options);

    RecyclerView recyclerView = findViewById(R.id.appointment_recyclerview);
    recyclerView.setHasFixedSize(true);
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
    recyclerView.setAdapter(adapter);
}

通过Logcat查看输出，确认：

• 是否有报错信息
• 是否查询到数据
• 数据字段是否与Model类匹配

四、Adapter监听时机与空安全问题 #

确保adapter.startListening()调用时adapter已初始化，避免空指针异常。

解决方案：
在onStart和onStop方法中添加空判断：

@Override
protected void onStart() {
    super.onStart();
    if (adapter != null) {
        adapter.startListening();
    }
}

@Override
protected void onStop() {
    super.onStop();
    if (adapter != null) {
        adapter.stopListening();
    }
}

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