上传Play Store时如何升级Room本地数据库且不影响旧用户数据？

直接上传新版本会影响旧用户吗？ #

会，且大概率引发严重问题：

• Room会检测到数据库schema（表结构）与实体类定义不匹配，若未配置正确迁移策略，应用会直接崩溃。
• 若开启了fallbackToDestructiveMigration()，Room会自动清空旧数据库并重建，旧用户的本地数据会全部丢失。

如何安全升级且不影响旧用户数据？ #

按以下步骤操作即可完成无损升级：

1. 升级数据库版本号 #

在RoomDatabase子类的@Database注解中，将version值从原版本号（比如1）递增至新版本号（比如2）：

@Database(
    entities = [User::class],
    version = 2, // 版本号+1
    // 后续添加迁移配置
)
abstract class AppDatabase : RoomDatabase() {
    // DAO定义
}

2. 修改实体类，新增字段 #

在对应的数据实体类中添加Mobile Number字段，同时为其设置默认值或允许为null，避免迁移时出现字段缺失错误：

@Entity(tableName = "users")
data class User(
    @PrimaryKey val id: Int,
    val name: String,
    val password: String,
    @ColumnInfo(name = "mobile_number", defaultValue = "") // 设置默认值，或用nullable = true允许为空
    val mobileNumber: String
)

3. 配置迁移策略 #

根据场景选择自动或手动迁移：

• 自动迁移（推荐，适合简单新增字段场景）：
  先在项目build.gradle中配置schema文件生成路径（供Room识别版本变更）：

  android {
      defaultConfig {
          javaCompileOptions {
              annotationProcessorOptions {
                  arguments += ["room.schemaLocation": "$projectDir/schemas".toString()]
              }
          }
      }
  }
  

  再在@Database注解中添加自动迁移配置：

  @Database(
      entities = [User::class],
      version = 2,
      autoMigrations = [AutoMigration(from = 1, to = 2)]
  )
  abstract class AppDatabase : RoomDatabase() {
      // ...
  }
  

  Room会自动生成迁移代码，无需手动编写SQL。

• 手动迁移（适合复杂结构变更）：
  创建Migration类，编写SQL语句添加新字段，再在数据库构建时注册迁移：

  val MIGRATION_1_2 = object : Migration(1, 2) {
      override fun migrate(database: SupportSQLiteDatabase) {
          database.execSQL("ALTER TABLE users ADD COLUMN mobile_number TEXT DEFAULT ''")
      }
  }
  

  构建数据库时添加迁移：

  Room.databaseBuilder(context, AppDatabase::class.java, "app_database")
      .addMigrations(MIGRATION_1_2)
      .build()
  

注意事项 #

• 不要随意启用fallbackToDestructiveMigration()，除非你明确接受数据丢失的后果。
• 升级前务必在测试环境模拟旧版本数据库（比如安装旧版应用生成数据后再安装新版），验证迁移过程是否正常、数据是否完整保留。

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