SQLite3.28.0环境下Room数据库无法使用Window Functions问题

根因说明 #

• 最低兼容版本限制：你配置的minSdkVersion = 23，而API 23内置的SQLite版本仅为3.8.10.2，远低于窗口函数要求的最低3.25版本。Room默认调用设备系统内置的SQLite实现，为了保证所有兼容范围内的设备都能正常运行，编译阶段就会拦截仅高版本SQLite支持的语法，不会因为编译/目标SDK是30就跳过该校验。
• Room编译校验逻辑限制：Room本身内嵌了独立的SQLite解析器做查询语法校验，部分低版本Room组件内嵌的SQLite解析版本低于3.25，即便你只在API 30及以上设备运行，编译阶段也会报错不识别窗口函数语法。

解决方案 #

• 方案1：提升最低兼容版本
  把minSdkVersion修改为30，仅适配API 30及以上设备，此时Room会直接启用高版本SQLite的特性支持。
• 方案2：引入独立SQLite依赖
  不依赖系统内置SQLite，引入官方独立分发的SQLite包，在全版本设备上统一SQLite版本：
  1. 在模块级build.gradle的dependencies块中添加依赖：

  // 可替换为适配你Room版本的最新稳定版
  implementation 'androidx.sqlite:sqlite-framework:2.4.0'
  implementation 'androidx.sqlite:sqlite-ktx:2.4.0'
  

  2. 初始化Room数据库时指定独立SQLite的OpenHelper工厂：

  val appDb = Room.databaseBuilder(
      context.applicationContext,
      AppDatabase::class.java, "你的数据库名"
  )
  .openHelperFactory(FrameworkSQLiteOpenHelperFactory())
  .build()
  

  调整完成后即可在所有minSdk兼容的设备上正常使用窗口函数特性。

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