如何在Kotlin的Room中使用现有SQLite数据库的DATE字段

核心问题原因 #

SQLite的DATE是类型亲和性标记，而非严格的强类型；但Room对字段类型的校验非常严格，默认情况下Date类型字段会被Room映射为INTEGER（因常用时间戳存储），和现有数据库的DATE类型亲和性不匹配，触发Schema校验失败。

可行解决方案 #

步骤1：确认现有数据库中releaseDate的实际存储格式

用SQLite工具执行以下命令，查看字段的真实存储类型：

SELECT typeof(releaseDate) FROM sets LIMIT 1;

返回结果通常为text（如2023-10-01格式的字符串）、integer（时间戳），根据结果选择对应方案。

方案A：适配字符串格式的DATE字段

若实际存储为text类型的日期字符串：

1. 实体类字段声明为String?，并指定类型亲和性为DATE：

@Entity(tableName = "sets")
data class Set(
    // 其他字段...
    @ColumnInfo(name = "releaseDate", typeAffinity = ColumnInfo.DATE)
    val releaseDate: String?
)

2. 编写String与Date的类型转换器：

class DateConverters {
    private val dateFormat = SimpleDateFormat("yyyy-MM-dd", Locale.getDefault())

    @TypeConverter
    fun stringToDate(dateStr: String?): Date? {
        return dateStr?.let { dateFormat.parse(it) }
    }

    @TypeConverter
    fun dateToString(date: Date?): String? {
        return date?.let { dateFormat.format(it) }
    }
}

3. 在Room数据库类上启用转换器：

@Database(entities = [Set::class], version = 1)
@TypeConverters(DateConverters::class)
abstract class AppDatabase : RoomDatabase() {
    // DAO定义...
}

方案B：适配整数时间戳格式的DATE字段

若实际存储为integer类型的时间戳：

1. 实体类字段保留Date?，但必须指定类型亲和性为DATE：

@Entity(tableName = "sets")
data class Set(
    // 其他字段...
    @ColumnInfo(name = "releaseDate", typeAffinity = ColumnInfo.DATE)
    val releaseDate: Date?
)

2. 保留Long与Date的转换器（注意时间戳单位是毫秒还是秒，按需调整）：

class DateConverters {
    @TypeConverter
    fun longToDate(timestamp: Long?): Date? {
        // 若为秒级时间戳，改为 Date(timestamp * 1000)
        return timestamp?.let { Date(it) }
    }

    @TypeConverter
    fun dateToLong(date: Date?): Long? {
        // 若为秒级时间戳，改为 date?.time?.div(1000)
        return date?.time
    }
}

3. 同样在数据库类上启用转换器（同上）。

关键注意事项

• 必须显式指定@ColumnInfo(typeAffinity = ColumnInfo.DATE)，这是让Room预期Schema与现有数据库对齐的核心。
• 若修改代码后仍报错，清理项目build目录后重新编译，避免Room缓存旧Schema。
• 不要依赖SQLite的隐式类型转换，Room不处理这类兼容，必须保证转换器与实际存储格式完全匹配。

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