Room迁移兼容现有BOOLEAN类型列的解决方案咨询

针对你遇到的Room迁移校验失败——现有SQLite表列类型（BOOLEAN/VARCHAR）与Room默认生成类型（INTEGER/TEXT）不匹配的问题，这里有几个实用的解决思路：

1. 显式指定列的类型亲和性（最推荐） #

Room允许通过@ColumnInfo注解的参数，强制生成与现有数据库完全一致的列类型，从根源上让校验时的类型字符串匹配。

处理BOOLEAN类型场景 #

修改实体类字段的注解，指定typeAffinity = ColumnInfo.BOOLEAN：

public class SomeEntity {
    @ColumnInfo(name = "someName", typeAffinity = ColumnInfo.BOOLEAN)
    public Boolean myValue;
}

这样Room生成的建表语句就会是CREATE TABLE someEntity (someName BOOLEAN)，和现有数据库通过PRAGMA table_info someEntity查询到的类型完全一致，迁移校验就能顺利通过。

处理VARCHAR类型场景 #

由于Room内置的类型常量没有直接对应VARCHAR的选项，你可以用customType参数指定自定义类型，同时保留TEXT的类型亲和性保证Room的映射逻辑正常：

public class AnotherEntity {
    @ColumnInfo(name = "stringColumn", typeAffinity = ColumnInfo.TEXT, customType = "VARCHAR")
    public String myString;
}

配置后Room会生成包含VARCHAR类型的建表语句，完美匹配现有数据库的列类型。

2. 自定义迁移逻辑并跳过默认校验（应急方案） #

如果暂时无法修改实体类配置，可以自定义Migration类，同时关闭Room的自动校验逻辑——但这种方法会失去架构校验的保护，可能隐藏其他潜在问题，建议谨慎使用：

Migration migration = new Migration(1, 2) {
    @Override
    public void migrate(@NonNull SupportSQLiteDatabase database) {
        // 在这里编写你的迁移逻辑，比如新增表、调整索引等
    }
};

AppDatabase db = Room.databaseBuilder(context, AppDatabase.class, "your-db-name")
        .addMigrations(migration)
        .fallbackToDestructiveMigration() // 仅极端情况使用，会清空旧数据
        .build();

另外，也可以通过@Database(exportSchema = false)禁用Schema文件生成，但同样会丢失自动校验的安全保障，不推荐长期使用。

补充说明 #

其实SQLite本身是弱类型的，BOOLEAN与INTEGER、VARCHAR与TEXT在实际存储和使用中行为几乎一致，但Room的迁移校验是严格匹配类型字符串的，所以只要让Room生成的建表语句类型与现有库完全一致，就能解决这个问题。

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