是否支持使用Android Room Database创建R*Tree类型的表？

API 探路者

2026-9-30

Room 使用 R-Tree 虚拟表实现方案

结论

Room 官方暂未提供类似 @FTS3/@FTS4 的 RTree 专属注解，但可以通过手动配置实现 R-Tree 表的正常使用，无需放弃 Room 框架。

你之前通过迁移执行建表 SQL 的逻辑是正确的，无法被 Room 识别是缺少对应 Entity 的适配配置，按以下步骤调整即可：

具体实现步骤

定义适配 RTree 表的 Entity
添加 @SkipQueryVerification 注解跳过 Room 的表结构校验（RTree 为虚拟表，Room 默认的实体结构校验规则会判定不匹配），字段和你建表语句的列完全对应即可：

@SkipQueryVerification
@Entity(tableName = "my_table_name")
data class RtreeEntry(
    @PrimaryKey val row_id: Long,
    val minX: Double,
    val maxX: Double,
    val minY: Double,
    val maxY: Double
)

将该 Entity 加入 RoomDatabase 的实体列表
在你的数据库类的 @Database 注解中添加该实体，同时禁止 Room 自动生成该表的建表语句，分两种场景处理建表逻辑：

首次安装新建数据库：在 RoomDatabase 的 onCreate 回调中执行你的 RTree 建表 SQL
已有版本升级：在你的数据库迁移逻辑中执行你写的那段建表 SQL 即可，原有逻辑不需要修改

编写正常的 Dao 操作
直接按照普通表的写法编写增删改查方法即可，Room 可以正常处理 RTree 表的所有SQL操作：

@Dao
interface RtreeEntryDao {
    // 范围查询示例：查询和给定坐标范围重叠的所有条目
    @Query("SELECT * FROM my_table_name WHERE minX <= :inputMaxX AND maxX >= :inputMinX AND minY <= :inputMaxY AND maxY >= :inputMinY")
    fun queryRangeOverlap(inputMinX: Double, inputMaxX: Double, inputMinY: Double, inputMaxY: Double): List<RtreeEntry>

    @Insert
    fun insert(entry: RtreeEntry)

    @Delete
    fun delete(entry: RtreeEntry)
}