Android Room自动迁移删除表操作时持续报错的技术问询

正确配置步骤 #

要解决删除表的自动迁移报错，严格按照以下步骤配置：

1. 创建AutoMigrationSpec实现类
   必须定义继承AutoMigrationSpec的类（不能是接口），并通过@DeleteTable.Entries指定要删除的表名（注意是数据库中实际存在的表名，不是实体类名：Room默认会把实体类名转为蛇形命名，比如SomeTable对应表名some_table；如果实体类用@Entity(tableName = "custom_name")指定了表名，就填该自定义名称）：

   import androidx.room.DeleteTable
   import androidx.room.AutoMigrationSpec
   
   @DeleteTable.Entries(
       DeleteTable(tableName = "some_table") // 替换为你的目标表名
   )
   class DeleteSomeTableSpec : AutoMigrationSpec
   

2. 更新@Database注解配置
   在数据库类的@Database注解中，升级版本到9，移除entities数组中的SomeTable::class，并在autoMigrations数组中关联上面的Spec类：

   import androidx.room.Database
   import androidx.room.RoomDatabase
   import androidx.room.AutoMigration
   
   @Database(
       entities = [/* 保留其他需要的实体类 */],
       version = 9,
       autoMigrations = [
           AutoMigration(from = 8, to = 9, spec = DeleteSomeTableSpec::class)
       ]
   )
   abstract class AppDatabase : RoomDatabase() {
       // 声明你的DAO接口
   }
   

排查常见错误 #

• 表名不匹配：如果报错仍存在，先通过SQLite工具查看数据库中的实际表名，确保DeleteTable注解中的tableName完全一致
• 缓存问题：执行Build -> Clean Project后再Rebuild Project，避免旧缓存导致的配置不生效
• 遗漏其他迁移变更：确认版本8到9之间只有删除表这一个变更，没有其他需要手动处理的结构修改

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