1. Room 数据库简介与核心概念归纳总结

1.1 Room 到底是什么？

做 Android 开发的同学，应该都跟 SQLite 打过交道。Room 说白了，就是 Google 官方在 SQLite 外面包了一层，帮我们把那些繁琐的 CRUD 操作、游标管理、SQL 拼接全封装好了。我个人最喜欢它的一点——编译时就能检查 SQL 语句对不对。

你想想看，以前用 SQLiteOpenHelper，写错一条 SQL 得跑到运行时才能发现，轻则崩溃，重则上线后才发现。我曾经在一个即时通讯项目里就吃过这个亏，一条删除语句少了个条件，结果用户聊天记录全没了……从那以后，我对运行时 SQL 校验就有了阴影。

Room 是 Jetpack 家族的核心成员之一，它不是要替代 SQLite，而是在 SQLite 之上提供了一层更安全、更高效的抽象。你可以把它理解成一个「带编译器保镖的 SQLite 管家」。

1.2 Room 的三大核心组件

要上手 Room，你必须先记住这三个东西：Entity、DAO、Database。它们各司其职，缺一不可。

这三者的关系其实很直白：Database 提供「房间」，Entity 定义「家具」的样式，DAO 就是「管家」——你告诉管家你想干什么，它帮你搞定。

1.3 Room 的工作流程

在实际项目中，我习惯按照下面的步骤来引入 Room，每一步都有明确的产出物：

1. 定义 Entity 类 —— 用 @Entity 标记，字段上加上 @PrimaryKey，指定表名和列名。
2. 创建 DAO 接口 —— 用 @Dao 标记，在里面声明你需要的查询方法。
3. 编写 Database 类 —— 继承 RoomDatabase，用 @Database 注解注册 Entity 和版本号。
4. 构建数据库实例 —— 通过 Room.databaseBuilder() 创建单例，建议加上 .fallbackToDestructiveMigration() 做开发期兜底。
5. 在 ViewModel / Repository 中注入 DAO —— 通过 DAO 调用数据方法，配合 LiveData 或 Flow 做响应式更新。

这套流程走下来，你基本不会漏掉什么。我记得刚带团队时，有个同事忘了在 Database 类里注册 Entity，结果编译通过了但一运行就崩，排查了半天……嗯，这种小坑踩过一次就记住了。

1.4 Room 的三大优势（为什么选它）

• 编译时 SQL 校验 —— 写错表名、列名、语法错误，编译阶段直接报红，不给你留到运行时的机会。
• 与 Jetpack 生态深度绑定 —— 原生支持 LiveData、Flow、Paging，写响应式数据层非常顺滑。
• 自动处理线程安全 —— 默认不允许在主线程操作数据库（除非你主动调用 .allowMainThreadQueries()），这其实是在逼你写出更健壮的代码。

1.5 性能调优：从入门就该有的意识

你可能会问：「第 1 章就谈性能调优，是不是太早了？」我的经验是——性能问题往往是在写第一行 Entity 时埋下的伏笔。举个例子：

• 如果你在 Entity 里用了 @Embedded 嵌套了一个大对象，Room 会默认把内嵌字段展开成多列。这本身没问题，但如果你嵌套了三层，一张表膨胀到五六十列，查询性能就会肉眼可见地下降。
• 如果你在 DAO 里写了一条 SELECT * FROM table WHERE column LIKE '%keyword%'，而且没加索引，数据量到 10 万条时，这条查询能卡到三秒以上。

所以说，性能调优不是等出问题了再补救，而是从 Entity 设计、DAO 编写、索引创建这一步就开始留意。后面我会拿大量真实案例跟你拆解，但今天先把这根弦绷上。

1.6 快速上手：一个完整的 Room 示例

光说不练假把式。下面是一个最精简的 Kotlin 示例，展示了 Entity、DAO、Database 三者如何配合：

// 1. 定义 Entity
@Entity(tableName = "users")
data class User(
    @PrimaryKey val id: Int,
    val name: String,
    val age: Int
)

// 2. 定义 DAO
@Dao
interface UserDao {
    @Query("SELECT * FROM users WHERE id = :userId")
    fun getUser(userId: Int): User?

    @Insert
    fun insertUser(user: User)
}

// 3. 定义 Database
@Database(entities = [User::class], version = 1)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao
}

// 4. 在 Application 中构建单例
val db = Room.databaseBuilder(
    context,
    AppDatabase::class.java,
    "my-room.db"
).build()

这段代码虽然简单，但它包含了 Room 的完整骨架。你在真实项目中，只需要在这个骨架上不断叠加新 Entity 和 DAO 方法就行。

1.7 写在开头的一些建议

Room 的门槛其实不高，但真正用好它、把它调到高性能状态，需要花功夫。这一章我们把核心概念和基础流程理清了，后面的内容会逐一深入：索引优化、查询计划分析、事务合并、Flow 与协程的最佳实践……每一条我都会结合真实项目中的踩坑经历来讲。

最后送你一句话：理解 Entity 就是理解数据模型，理解 DAO 就是理解查询效率，理解 Database 就是理解连接生命周期。把这三样东西吃透，Room 的性能调优你已经掌握了 70%。