如何将Android Room数据表列的notNull属性从true修改为false

核心问题原因 #

你手动修改的JSON schema文件是Room编译阶段根据Entity实体类自动生成的产物，不属于可手动修改的配置文件，每次项目编译时都会被自动覆盖，这就是你修改后重启项目属性自动变回notNull=true的根本原因。

正确修改步骤 #

• 第一步：修改Entity实体类定义
  把需要取消非空约束的字段（对应QuestionID、QuoteID、TermID、Deleted）改为可空类型：
  • Java环境：将基础类型int替换为包装类型Integer
  • Kotlin环境：将非空类型Int替换为可空类型Int?
    Room会自动根据字段的可空性生成对应的非空约束配置，不需要手动修改JSON文件。
• 第二步：升级数据库版本号
  在你的Room数据库注解配置处将version属性+1，比如之前是@Database(version = 2, ...)就改为version = 3。
• 第三步：编写正确的数据库迁移逻辑
  SQLite本身不支持直接通过ALTER TABLE修改已有列的非空约束，需要按照临时表迁移的标准流程操作，示例代码如下：

// 示例为从版本2迁移到版本3，根据你的实际版本号调整
static final Migration MIGRATION_2_3 = new Migration(2, 3) {
    @Override
    public void migrate(SupportSQLiteDatabase database) {
        // 1. 创建符合新结构的临时表，对应字段去掉NOT NULL约束
        database.execSQL("CREATE TABLE IF NOT EXISTS `Notes_temp` (`NoteID` INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, `SourceID` INTEGER NOT NULL, `CommentID` INTEGER NOT NULL, `QuestionID` INTEGER, `QuoteID` INTEGER, `TermID` INTEGER, `TopicID` INTEGER NOT NULL, `Deleted` INTEGER, FOREIGN KEY(`SourceID`) REFERENCES `Source`(`SourceID`) ON UPDATE NO ACTION ON DELETE NO ACTION , FOREIGN KEY(`CommentID`) REFERENCES `Comment`(`CommentID`) ON UPDATE NO ACTION ON DELETE NO ACTION , FOREIGN KEY(`TopicID`) REFERENCES `Topic`(`TopicID`) ON UPDATE NO ACTION ON DELETE NO ACTION )");
        // 2. 迁移旧表数据到临时表
        database.execSQL("INSERT INTO Notes_temp (NoteID, SourceID, CommentID, QuestionID, QuoteID, TermID, TopicID, Deleted) SELECT NoteID, SourceID, CommentID, QuestionID, QuoteID, TermID, TopicID, Deleted FROM Notes");
        // 3. 删除旧表
        database.execSQL("DROP TABLE Notes");
        // 4. 临时表重命名为原表名
        database.execSQL("ALTER TABLE Notes_temp RENAME TO Notes");
    }
};

• 第四步：将迁移实例注册到Room数据库构建器中，示例如下：

Room.databaseBuilder(context, YourDatabase.class, "your_db_name.db")
    .addMigrations(MIGRATION_2_3)
    // 不要随意开启fallbackToDestructiveMigration，会清空所有本地数据
    .build();

• 第五步：重新编译项目，Room会自动生成新的schema JSON文件，对应字段的notNull属性会自动更新为false。

注意事项 #

如果你使用了预填充数据库，需要提前修改你的预填充db文件，确保对应列已经移除了NOT NULL约束，否则运行时Room会触发schema校验不匹配的报错。

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