Android Studio的Database Inspector始终显示Room数据库为closed如何解决

问题根因 #

Room默认采用懒加载机制，仅当首次执行实际的增删改查操作时才会真正建立数据库连接，你当前只初始化了Room实例但没有触发实际IO操作，因此连接未建立，Database Inspector无法识别到打开的数据库。

解决方法 #

• 触发一次数据库操作：在应用运行时调用任意Dao层的增删改查方法，注意要在子线程（或协程IO调度器）执行，操作完成后刷新Database Inspector面板即可看到打开的数据库。
• 临时调试强制初始化：如果需要在应用启动后就直接查看数据库，可以在调试阶段添加强制初始化连接的逻辑，仅在Debug包生效，避免影响线上性能，示例代码如下：

private fun buildDatabase(context: Context): AppDatabase {
    return Room.databaseBuilder(context, AppDatabase::class.java, DATABASE_NAME)
        .addCallback(
            object : RoomDatabase.Callback() {
                override fun onCreate(db: SupportSQLiteDatabase) {
                    super.onCreate(db)
                }
            }
        ).fallbackToDestructiveMigration()
        .build()
        .apply {
            // 仅Debug环境下执行，强制触发数据库连接初始化
            if (BuildConfig.DEBUG) {
                openHelper.writableDatabase
            }
        }
}

其他排查项 #

• 确认Android Studio版本不低于4.1，运行应用的设备/模拟器系统版本不低于API 21
• 若开启了代码混淆，需确保已添加Room官方混淆规则，避免相关类被裁剪导致检测异常
• 确认数据库存储路径为应用私有目录（默认路径即为私有目录，若未手动修改可忽略），Database Inspector暂不支持读取外部存储路径下的数据库
• 若上述操作完成后仍显示closed，点击Database Inspector面板的刷新按钮，或重启adb、重新连接设备即可

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