如何安全移除数据库Room实体，避免影响旧版本兼容性？

问题根源 #

你删除了针对该实体的手动迁移脚本，但旧版本安装包的数据库中仍存在该实体对应的表。当用户从旧版本升级到当前版本时，Room无法自动处理旧表的移除操作，导致数据库结构校验失败，引发应用崩溃。

解决步骤 #

• 恢复并补全移除实体的手动迁移脚本
  针对从包含该实体的最后一个版本（假设是版本13）到当前版本（14）的迁移，添加删除表的SQL语句：

  static final Migration MIGRATION_13_14 = new Migration(13, 14) {
      @Override
      public void migrate(@NonNull SupportSQLiteDatabase database) {
          // 用IF EXISTS避免表不存在的异常
          database.execSQL("DROP TABLE IF EXISTS `YourEntityTableName`");
      }
  };
  

  注意替换YourEntityTableName为实际的表名（Room默认用实体类名，除非你用@Table指定了其他名称）。

• 确保迁移脚本被正确注册到Room数据库
  在创建RoomDatabase实例时，将上述迁移脚本添加到构建器中：

  Room.databaseBuilder(context, AppDatabase.class, "your_database_name")
      .addMigrations(MIGRATION_13_14)
      .build();
  

• 暂时保留旧实体类（可选但保险）
  如果你不确定所有用户都已升级到不依赖该实体的版本，可以暂时保留实体类，标记为@Deprecated，但不要将其加入新版本RoomDatabase的entities数组中。等确认所有用户完成升级后，再彻底删除实体类及相关代码。

• 全路径升级测试
  安装仍在使用该实体的最旧版本，插入测试数据后升级到当前版本，验证崩溃是否消失；同时测试中间版本到当前版本的升级流程，确保整个迁移链完整无问题。

关键说明 #

Room的自动迁移仅能处理新增、修改字段等简单结构变更，无法自动删除表。因此移除实体必须通过手动迁移脚本明确执行DROP TABLE操作，否则旧版本升级时会因数据库结构与新版本实体定义不匹配而崩溃。

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