已有SQLite数据库BigInt时间戳列的RoomDB实体创建问题

首先要明确：SQLite是动态类型系统，BIGINT本质是INTEGER的别名，所以Room生成INTEGER列是正常行为，完全不影响数据的存储和读取——因为Long类型在SQLite中就是以INTEGER（对应SQLite的64位整数）存储，和原数据库的BIGINT是完全兼容的。

要让Room实体正确映射到已有数据库的BIGINT列，只需按以下方式处理：

方式1：直接用Long类型映射 #

在实体类中使用Long类型，并通过@ColumnInfo显式指定列的类型亲和性为BIGINT，确保Room生成的结构和原数据库匹配：

@Entity(tableName = "your_target_table")
data class TargetEntity(
    @PrimaryKey val id: Int,
    // 显式指定列类型为BIGINT，对应原数据库的字段
    @ColumnInfo(name = "datetime_ticks", typeAffinity = ColumnInfo.BIGINT)
    val datetimeTicks: Long
)

方式2：用自定义DateTime类型+转换器 #

如果想在代码中使用更直观的日期时间类型（比如LocalDateTime），需要编写类型转换器，并同样指定列的类型亲和性：

1. 编写类型转换器 #

根据你的Ticks基准（比如是1970-01-01的毫秒数，还是.NET风格的100纳秒数）实现转换逻辑：

class DateTimeTickConverter {
    // 将Long类型的Ticks转为LocalDateTime
    @TypeConverter
    fun ticksToLocalDateTime(ticks: Long): LocalDateTime {
        // 示例：如果Ticks是从1970-01-01开始的毫秒数
        val instant = Instant.ofEpochMilli(ticks)
        return LocalDateTime.ofInstant(instant, ZoneId.systemDefault())
    }

    // 将LocalDateTime转为Long类型的Ticks
    @TypeConverter
    fun localDateTimeToTicks(dateTime: LocalDateTime): Long {
        return dateTime.atZone(ZoneId.systemDefault())
            .toInstant()
            .toEpochMilli()
    }
}

2. 在数据库类中注册转换器 #

@Database(entities = [TargetEntity::class], version = 1)
@TypeConverters(DateTimeTickConverter::class)
abstract class AppDatabase : RoomDatabase() {
    abstract fun targetDao(): TargetDao
}

3. 实体类中使用自定义日期类型 #

@Entity(tableName = "your_target_table")
data class TargetEntity(
    @PrimaryKey val id: Int,
    @ColumnInfo(name = "datetime_ticks", typeAffinity = ColumnInfo.BIGINT)
    val datetime: LocalDateTime
)

关键说明 #

即便Room生成的列显示为INTEGER，也无需担心——SQLite会自动处理类型兼容，原数据库的BIGINT字段和Room的INTEGER列可以无缝读写。显式指定typeAffinity = ColumnInfo.BIGINT的作用是让Room生成的建表语句和原数据库结构一致，避免后续数据库迁移时出现结构不匹配的问题。

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