Android Room数据库迁移报错：尝试重新打开已关闭的SQLiteDatabase

排查与修复步骤 #

• 确认Migration注册与版本配置
  必须在RoomDatabase的@Database注解中正确指定目标版本，并在数据库构建时传入对应的Migration实例，版本号必须严格递增。示例代码：

  // 数据库定义
  @Database(entities = {MenuItem.class}, version = 2)
  public abstract class AppDatabase extends RoomDatabase {
      public abstract MenuDao menuDao();
  
      public static final Migration MIGRATION_1_2 = new Migration(1, 2) {
          @Override
          public void migrate(SupportSQLiteDatabase database) {
              database.execSQL("ALTER TABLE menuItems ADD COLUMN cnt INTEGER DEFAULT 0 NOT NULL");
          }
      };
  }
  
  // 初始化数据库
  AppDatabase db = Room.databaseBuilder(context, AppDatabase.class, "app_database")
          .addMigrations(AppDatabase.MIGRATION_1_2)
          .build();
  

  若未正确注册Migration，Room可能尝试自动迁移失败后关闭连接，导致后续操作报错。

• 避免migrate方法内的耗时操作
  Room会在迁移期间管理SupportSQLiteDatabase对象的生命周期，若执行的SQL操作耗时过长（比如批量数据迁移），可能触发连接被提前关闭。确保ALTER TABLE这类语句简洁，复杂迁移可拆分为多个小版本逐步执行。

• 排查跨线程数据库访问冲突
  迁移过程中Room会锁定数据库，若此时有其他线程持有未关闭的数据库连接，可能导致当前迁移连接被强制关闭。确保迁移开始前，所有其他数据库操作都已完成并释放连接。

• 验证数据库文件完整性
  旧数据库文件损坏也可能引发此类异常。可先卸载应用清除旧数据，重新测试迁移流程，排除文件损坏问题。

• 兜底方案：破坏性迁移（谨慎使用）
  若上述方法都无效，且数据可丢弃，可使用fallbackToDestructiveMigration()，它会删除旧数据库并根据当前实体类重建，但会丢失所有旧数据：

  AppDatabase db = Room.databaseBuilder(context, AppDatabase.class, "app_database")
          .fallbackToDestructiveMigration()
          .build();
  

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