Android Room数据库迁移：批量删除@Embedded嵌入列的简便方法

当你需要在Room数据库升级中删除实体类里的@Embedded对象对应的所有列，又不想逐个添加@DeleteColumn注解时，可以通过在AutoMigrationSpec中执行原生SQL批量处理的方式解决，具体实现如下：

• 借助SQLite的PRAGMA table_info()查询目标表的所有列，筛选出@Embedded对象对应的前缀列（比如示例中的c_开头）
• 批量执行ALTER TABLE DROP COLUMN语句删除这些列

代码示例 #

class MigrateFrom28To29 : AutoMigrationSpec {
    override fun onPostMigrate(db: SupportSQLiteDatabase) {
        super.onPostMigrate(db)
        
        // 查询表A的所有列信息
        val cursor = db.rawQuery("PRAGMA table_info(A)", null)
        val targetColumns = mutableListOf<String>()
        
        // 筛选出c_前缀的列
        while (cursor.moveToNext()) {
            val columnName = cursor.getString(cursor.getColumnIndexOrThrow("name"))
            if (columnName.startsWith("c_")) {
                targetColumns.add(columnName)
            }
        }
        cursor.close()
        
        // 用事务保证批量删除操作的原子性
        db.beginTransaction()
        try {
            targetColumns.forEach { column ->
                db.execSQL("ALTER TABLE A DROP COLUMN $column")
            }
            db.setTransactionSuccessful()
        } finally {
            db.endTransaction()
        }
    }
}

注意事项 #

• SQLite从3.35.0版本开始支持ALTER TABLE DROP COLUMN，如果App需要兼容更低版本设备，建议采用创建临时表迁移数据后替换原表的方式（逻辑类似，同样可批量处理列）
• 确保@Embedded对象的列前缀唯一，避免误删其他业务列
• 自定义删除操作建议放在onPostMigrate中执行，确保AutoMigration的默认升级逻辑完成后再处理

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