Android Studio使用Room框架无法创建数据库文件问题求助

核心原因 #

Room仅调用Room.databaseBuilder()构建实例时不会生成物理数据库文件，只有首次执行读写操作时才会触发数据库的实际创建，这是你找不到数据库文件的最常见原因。

排查步骤 #

• 修正数据库存在检测方法语法错误
  你提供的检测方法返回值类型声明错误，会导致编译不通过，修正后代码如下：

private static boolean doesDatabaseExist(Context context, String dbName) {
    File dbFile = context.getDatabasePath(dbName);
    String path = dbFile.getAbsolutePath();
    return dbFile.exists();
}

• 触发首次数据库读写操作
  在插件入口onCreate方法初始化数据库实例后，执行一次测试读写操作，触发数据库文件生成：

AppDatabase db = AppDatabase.getInstance(yourContext);
// 插入测试数据触发数据库创建
db.NoteDao().insert(new Note("test_data"));

操作完成后再次检测数据库存在状态，即可正常返回true，数据库默认生成路径为data/data/[宿主应用包名]/databases/exampleDB，在Device File Explorer和Database Inspector中均可正常识别。

• 验证传入的Context有效性
  由于你的项目是其他应用的插件，必须确认传入buildDatabaseInstance方法的Context是宿主应用的有效Context，如果传入插件自身的Context，数据库会生成在插件单独的沙盒路径下，搜索宿主应用路径时无法找到。

• 确认进程匹配
  使用Database Inspector时，需要在进程选择下拉框中选中宿主应用的运行进程，才能看到对应进程下生成的数据库文件。

• 检查Room依赖配置
  确认Java项目使用annotationProcessor引入Room编译依赖，不能用kapt替代，参考配置如下：

dependencies {
    def room_version = "2.5.0"
    implementation "androidx.room:room-runtime:$room_version"
    annotationProcessor "androidx.room:room-compiler:$room_version"
}

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