Kotlin下Firebase实时数据库嵌套对象数据存储方法

Firebase 实时数据库的 SDK 自带序列化能力，存嵌套数据不需要手动拼接节点路径，直接按数据结构定义 data 类，SDK 会自动把对象属性映射成数据库的嵌套节点，实现非常简单。

核心实现步骤 #

• 按你需要的数据库层级逐层定义 data 类，所有属性必须设置默认初始值，避免 Firebase 反序列化时因缺少空构造函数报错。
  举个例子，如果你需要的用户存储结构是：
  1. 根节点Userdata下以用户uid为key存每个用户的数据
  2. 每个用户节点下除了基础的username、uid字段，还有嵌套的profile（用户资料）、settings（用户设置）子节点
     直接按下面的方式定义数据类即可：

// 定义嵌套结构：用户资料子节点
data class UserProfile(
    val avatarUrl: String = "",
    val nickname: String = "",
    val bio: String = ""
)

// 定义嵌套结构：用户设置子节点
data class UserSettings(
    val pushNotificationEnabled: Boolean = true,
    val darkModeEnabled: Boolean = false
)

// 定义外层用户主结构，将嵌套类作为属性传入
data class UserData(
    val username: String = "",
    val uid: String = "",
    val profile: UserProfile = UserProfile(),
    val settings: UserSettings = UserSettings()
)

• 写入数据时直接构造完整的嵌套对象，你之前用的setValue()方法不需要做任何修改，SDK 会自动生成嵌套结构：

val database = FirebaseDatabase.getInstance().getReference("Userdata")
uid?.let { userId ->
    // 构造完整的带嵌套结构的用户数据
    val user = UserData(
        username = "Test1",
        uid = userId,
        profile = UserProfile(
            nickname = "测试用户",
            bio = "这是个人简介"
        ),
        settings = UserSettings(
            pushNotificationEnabled = true
        )
    )

    database.child(userId).setValue(user)
        .addOnSuccessListener {
            Toast.makeText(this, "保存成功", Toast.LENGTH_LONG).show()
        }
        .addOnFailureListener {
            Toast.makeText(this, "保存失败", Toast.LENGTH_LONG).show()
        }
}

临时嵌套数据的简便写法 #

如果只是少量临时的嵌套字段不需要复用，也可以直接用嵌套的 Map 结构写入，不需要额外定义data类：

uid?.let { userId ->
    val userMap = mapOf(
        "username" to "Test1",
        "uid" to userId,
        // 嵌套的Map会自动映射为数据库的子节点
        "profile" to mapOf(
            "nickname" to "测试用户",
            "bio" to "这是个人简介"
        )
    )
    database.child(userId).setValue(userMap)
}

长期维护的项目优先用data类的写法，编译时就能检查字段名，不容易写错key。

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