从SQLite迁移至Room遇转换错误：VARCHAR类型引发问题

兄弟，我太懂你这种踩坑的懊恼了——跟着教程用了VARCHAR，现在迁Room出问题确实闹心。不过先放宽心：SQLite里的VARCHAR()和TEXT本质是完全等价的，SQLite对字符串类型根本没长度限制，VARCHAR只是个语法糖而已，问题大概率出在Room的Schema校验逻辑上。下面给你几个实用的解决思路：

1. 给实体类字段显式指定VARCHAR类型 #

直接在@ColumnInfo注解里加上type参数，让Room生成的Schema和你原SQLite数据库的类型声明完全对齐，这样校验就不会报错了：

@Entity(tableName = "conversation") 
class Conversation(
    @PrimaryKey @ColumnInfo(name = "key") val key: Int, 
    @ColumnInfo(name = "message_id", type = "VARCHAR") val messageId: String?, 
    @ColumnInfo(name = "thread_id", type = "VARCHAR") val threadId: String?, 
    @ColumnInfo(name = "address", type = "VARCHAR") val address: String?
    // 其他字符串字段都照这个格式加type参数
)

这个方法最直接，相当于告诉Room：“别默认用TEXT了，我这个字段对应原库的VARCHAR”。

2. 写自定义Migration脚本兼容类型 #

如果上面的方法还解决不了，就手动写迁移脚本，明确告诉Room怎么处理新旧Schema的差异。比如假设你是从原SQLite的版本1迁到Room的版本2，代码可以这么写：

// 定义迁移规则：从版本1到版本2
val MIGRATION_1_2 = object : Migration(1, 2) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 划重点：因为VARCHAR和TEXT在SQLite里完全兼容，这里根本不需要修改表结构
        // 如果原表还有其他需要调整的地方（比如加字段），再在这里写ALTER TABLE之类的SQL
        // 现在只需要让Room认可这个类型兼容的变化就行
    }
}

然后在创建RoomDatabase的时候把这个迁移加进去：

@Database(entities = [Conversation::class], version = 2)
abstract class AppDatabase : RoomDatabase() {
    abstract fun conversationDao(): ConversationDao

    companion object {
        fun getInstance(context: Context): AppDatabase {
            return Room.databaseBuilder(
                context.applicationContext,
                AppDatabase::class.java,
                "你的数据库名"
            )
            .addMigrations(MIGRATION_1_2) // 加上自定义迁移
            .build()
        }
    }
}

3. 临时关闭Schema校验（仅调试用！） #

如果只是想快速验证功能，不想折腾迁移脚本，可以临时关闭Room的严格校验，但这个方法绝对不能用在生产环境——要么会丢数据，要么会隐藏潜在的Schema问题：

Room.databaseBuilder(...)
    // 这个会直接删了旧库重建，数据全丢，慎用！
    .fallbackToDestructiveMigration()
    // 或者用这个忽略迁移警告，不会丢数据，但可能隐藏问题
    .ignoreMigrationWarnings()
    .build()

最后再啰嗦一句 #

SQLite是弱类型数据库，不管你写VARCHAR、TEXT还是CHAR，存的都是字符串，Room之所以报错，只是因为它默认认为String字段对应TEXT类型，和你原库的VARCHAR类型名称对不上。所以核心思路要么是让Room的预期类型和原库对齐，要么是告诉Room忽略这个名称差异。

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