用了这么多年 Room，你可NengYi经hen习惯它的那套 API 了。

但这次Google 直接换了包名、砍了 Java 代码生成、干掉了 KAPT，连同步 DAO 方法dou不让写了。

是的，这是一次“断舍离”式的大版本升级。

Room 从 年发布到现在一直是 Android 端Zui流行的数据库框架，没有之一。

但它有一个一直被诟病的问题：只Neng在 Android 上用。

Room 3.0 的背景：跨平台的需求

随着 Kotlin Multiplatform在 Google 内部的全面推进，Jetpack 的多个核心库dou在Zuo跨平台适配。Room 自然也不例外。

但问题是Room 的底层深度绑定了 Android 的 SupportSQLite API，想要跨平台，必须换底座。小修小补解决不了问题。

“大破大立”：为何是全新的版本

所以 Google 选择了“大破大立”——直接发布 大版本，一次性清理历史包袱。

四大核心变化：你需要知道什么 全新包名

依赖从 androidx.room:room-runtime 变成了 androidx.room3:room3-runtime，类的包名也从 androidx.room 迁移到了 android.room3。

这意味着 Room .x 和 Ke以在同一个项目中共存，方便渐进式迁移。但也意味着——所有 import 要改一遍！

砍掉 Java 代码生成

Room 只生成 Kotlin 代码。Ru果你的项目还在用 Java 写 DAO 和 Entity ，是时候迁移了！

仅支持 KSP

KAPT 和 Java 注解处理器dou被移除了。Room 是一个纯粹的 KSP处理器 。

协程优先：告别同步 DAO

这可Neng是影响Zui大的变化。Room 要求所有 DAO 方法必须是suspend函数 或者返回 Flow 等响应式类型 。 同步的、阻塞式的DAO 方法？ 不支持了 ！

//❌ Room 不再允许@Queryfun getUserById: User//✅必须使用 suspend@Querysuspend fun getUserById: User//✅或者返回 Flow@Queryfun getAllUsers: Flow

迁移路径：循序渐进

kan到这些破坏性变化 ，你可Neng会有点慌 。别急 ，Google 给了一条比较清晰的迁移路径 。

第一步 ：迁移 SQLite驱动

从Room . 开始 ，就Ke以使用新的 androidx .sqlite驱动API 了 。建议现在就开始迁 ，不要再写新的SupportSQLite代码 。

第二步 ：用兼容层过渡

Room .提供了 room -sqlite -wrapper桥接库 ，Ke以把RoomDatabase转换为SupportSQLiteDatabase 。这样你Ke以渐进式替换 ，而不是一次性改完所有代码 。

第三步 ：切换到Room

等稳定后 ，替换包名和依赖 。由于 x 和 Ke以共存 ，你甚至Ke以按模块逐步切换 。

跨平台Neng力：geng大的野心

Neng用 ，但进入了维护模式 。

Google 会继续发布 、这样的补丁版本修复bug和安全问题 但不会再有新功Neng加入。

所以Ru果你的项目目前运行稳定不必急着迁移 但Ru果是新项目建议直接从 开始哪怕它现在还是Alpha。

因为迁移的成本只会越来越高不如早走一步。

RoomZui大的亮点其实是跨平台Neng力。

通过KMP支持 不仅Neng在Android上运行还新增了JavaScript和WebAssembly平台的支持。

Web端通过新的 androidx .sqlite :sqlite -web驱动实现底层是一个基于Web Worker的方案利用Origin Private File SystemZuo数据持久化。

这意味着什么 你Ke以用同一套定义的数据Schema 在Android iOS 通过KMP 以及Web端共享数据层逻辑。

对于Zuo跨平台项目的团队来说这是一个非常有价值的Neng力 再也不需要每个平台各写一套数据库操作了。 .

---