如何将Firestore中存储map结构的数组映射到RecyclerView？

报错原因 #

你遇到的反序列化失败问题，通常是以下几个原因导致的：

• Kotlin 数据类没有为属性设置默认值，Firebase SDK 反序列化时需要依赖无参构造方法，若数据类所有参数都没有默认值，编译器不会生成无参构造，就会抛出该异常
• 代码混淆导致类名、属性名被修改，Firebase 无法匹配到对应字段
• 字段名和 Firestore 中存储的字段名不匹配（你当前的字段名是匹配的，可排除该问题）

方案一：修改数据类适配自动序列化 #

直接调整User数据类的定义，添加默认值、防混淆注解和字段显式绑定，即可支持 Firebase 自动反序列化：

import androidx.annotation.Keep
import com.google.firebase.firestore.PropertyName

@Keep // 防止混淆时类、属性被重命名
data class User(
    @PropertyName("name") val name: String = "", // 显式绑定Firestore字段，设置默认值
    @PropertyName("pic") val pic: String = ""
)

修改完成后就可以直接用Firebase的toObject方法解析数组，示例代码如下：

val userList = arrayListOf<User>()
// 替换为你自己的文档引用
docRef.get().addOnSuccessListener { snapshot ->
    if (snapshot.exists()) {
        // 直接解析为User类型的列表
        val users = snapshot.get("users", object : TypeToken<List<User>>() {}.type) as? List<User> ?: emptyList()
        userList.addAll(users)
        // 通知适配器更新数据
        adapter.notifyDataSetChanged()
    }
}

方案二：手动解析数组（稳定性更高） #

如果不想调整数据类，或者自动序列化还是出现异常，可以手动读取数组内容转成对象，避免序列化适配问题：

val userList = arrayListOf<User>()
// 替换为你自己的文档引用
docRef.get().addOnSuccessListener { snapshot ->
    if (snapshot.exists()) {
        // 先读取数组为Map列表
        val usersMap = snapshot.get("users") as? List<Map<String, Any>> ?: emptyList()
        // 遍历Map转成User对象
        usersMap.forEach { item ->
            val name = item["name"] as? String ?: ""
            val pic = item["pic"] as? String ?: ""
            userList.add(User(name, pic))
        }
        // 通知适配器更新数据
        adapter.notifyDataSetChanged()
    }
}.addOnFailureListener {
    // 自行处理读取失败的逻辑
    it.printStackTrace()
}

注意事项 #

• 若使用自动序列化方案，需要确保项目引入了firebase-firestore-ktx依赖，且所有Firebase相关依赖版本一致
• Firestore安全规则需要放开对应文档的读权限，否则会读取失败
• 手动解析时做好空类型判断，避免数组内存在空值、字段类型不匹配导致崩溃

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