Android Room预填充数据库类型不匹配问题求助

核心区别说明 #

Java里的int（基本类型）和Integer（包装类），在Room的映射规则里都会对应SQLite的INTEGER类型——SQLite本身没有单独的Integer类型，只有INTEGER类型亲和性，两者的本质差异仅在于：

• int不允许为null，映射到SQLite的INTEGER NOT NULL
• Integer允许为null，映射到SQLite的INTEGER

你改int为Integer没用，大概率是以下几个原因，对应解决步骤如下：

1. 实体类注解配置错误 #

检查Hierarchy实体类中member_id字段的注解，确保没有指定错误的类型亲和性。正确写法示例：

// 包装类允许null
@ColumnInfo(name = "member_id")
private Integer memberId;

// 基本类型不允许null
@ColumnInfo(name = "member_id")
private int memberId;

如果之前加了@ColumnInfo(typeAffinity = ColumnInfo.TEXT)这类错误配置，会强制把字段映射为TEXT类型，导致和Room期望的INTEGER不匹配，删掉错误的typeAffinity配置即可。

2. 数据库版本未升级 #

修改实体类后，Room不会自动更新已有数据库的表结构。你需要：

• 在@Database注解中把版本号+1，比如@Database(entities = {Hierarchy.class}, version = 2)
• 选择数据保留策略：
  • 允许清空数据：添加fallbackToDestructiveMigration()，会删除旧表重建，代码示例：

    Room.databaseBuilder(context, YourDatabase.class, "db_name")
        .fallbackToDestructiveMigration()
        .build();
    

  • 需要保留数据：编写Migration类修改表结构，示例如下（假设旧表字段类型错误）：

    static final Migration MIGRATION_1_2 = new Migration(1, 2) {
        @Override
        public void migrate(SupportSQLiteDatabase db) {
            // 1. 创建临时表，指定正确的INTEGER类型
            db.execSQL("CREATE TABLE hierarchy_temp (id INTEGER PRIMARY KEY AUTOINCREMENT, member_id INTEGER NOT NULL, 其他字段...)");
            // 2. 复制旧表数据到临时表
            db.execSQL("INSERT INTO hierarchy_temp SELECT id, member_id, 其他字段... FROM hierarchy");
            // 3. 删除旧表，重命名临时表为原表名
            db.execSQL("DROP TABLE hierarchy");
            db.execSQL("ALTER TABLE hierarchy_temp RENAME TO hierarchy");
        }
    };
    

    然后在数据库构建时添加Migration：

    Room.databaseBuilder(context, YourDatabase.class, "db_name")
        .addMigrations(MIGRATION_1_2)
        .build();
    

3. 旧表结构残留问题 #

如果之前的数据库表中member_id实际是其他类型（比如TEXT），即使修改实体类，旧表结构不会自动变更。通过SQLite工具确认表结构后，按照上面的Migration方案修正即可。

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