Firebase报错：无法将String转为Message实体类，如何解决？

问题描述 #

尝试将RecyclerView与Firebase结合，Firebase结构为Message节点下的键是通过push()生成的随机值，对应的值是测试消息。编写了Message数据类、MainActivity及MessageAdapter代码后，应用崩溃并抛出错误：

com.google.firebase.database.DatabaseException: Can't convert object of type java.lang.String to type com.example.myapplication.Message

提供的代码如下：

Model #

data class Message (val message: String? = null)

MainActivity #

private lateinit var mAdapter: MessageAdapter
...

myRef = FirebaseDatabase.getInstance().getReference("Message")

//Set database query
val messages = FirebaseRecyclerOptions.Builder<Message>()
    .setQuery(myRef, Message::class.java)
    .build()

mAdapter = MessageAdapter(messages)

//Read data
val rv = findViewById<RecyclerView>(R.id.messages_rv)
rv.layoutManager = LinearLayoutManager(this)
rv.adapter = mAdapter

Adapter #

class MessageAdapter(messages: FirebaseRecyclerOptions<Message>) :
    FirebaseRecyclerAdapter<Message, MessageAdapter.ViewHolder>(messages) {

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
        return ViewHolder(
            LayoutInflater.from(parent.context).inflate(R.layout.message_row, parent, false)
        )
    }

    override fun onBindViewHolder(holder: ViewHolder, position: Int, model: Message) {
        holder.message.text = model.message
    }

     class ViewHolder(view: View) : RecyclerView.ViewHolder(view) {
        val message: TextView = view.findViewById(R.id.message_tv)
    }
}

错误原因 #

崩溃的核心原因是Firebase数据库中Message节点下的子节点存储的是字符串，而代码期望将这些子节点转换为Message类对象。

当前数据库结构示例：

Message
  - 随机push键1: "测试消息1"
  - 随机push键2: "测试消息2"

但FirebaseRecyclerAdapter配合Message::class.java时，期望每个子节点是包含message字段的对象结构，正确结构应为：

Message
  - 随机push键1
    - message: "测试消息1"
  - 随机push键2
    - message: "测试消息2"

解决方案 #

方案1：修正数据库数据结构（推荐） #

确保写入Firebase时存储的是Message对象，而非直接存字符串。修改写入代码：

// 错误写法（直接存字符串）
// myRef.push().setValue("测试消息")

// 正确写法（存Message对象）
myRef.push().setValue(Message("测试消息"))

调整后数据库结构将匹配Message类的映射要求，原有的MainActivity和Adapter代码无需修改即可正常运行。

方案2：适配现有字符串结构（仅用于无法修改数据库的场景） #

如果无法修改已有的数据库结构，需调整代码直接读取字符串：

1. 修改FirebaseRecyclerOptions的泛型为String：

val messages = FirebaseRecyclerOptions.Builder<String>()
    .setQuery(myRef, String::class.java)
    .build()

2. 修改MessageAdapter适配String类型：

class MessageAdapter(messages: FirebaseRecyclerOptions<String>) :
    FirebaseRecyclerAdapter<String, MessageAdapter.ViewHolder>(messages) {

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
        return ViewHolder(
            LayoutInflater.from(parent.context).inflate(R.layout.message_row, parent, false)
        )
    }

    override fun onBindViewHolder(holder: ViewHolder, position: Int, model: String) {
        holder.message.text = model
    }

     class ViewHolder(view: View) : RecyclerView.ViewHolder(view) {
        val message: TextView = view.findViewById(R.id.message_tv)
    }
}

额外注意事项 #

• 确保Firebase Realtime Database的规则允许读取Message节点（开发阶段可临时设置为公开读写，上线后需调整为安全规则）。
• 需在MainActivity的生命周期方法中启动/停止监听：

override fun onStart() {
    super.onStart()
    mAdapter.startListening()
}

override fun onStop() {
    super.onStop()
    mAdapter.stopListening()
}

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