Android导入外部数据库失败：Room未识别非空类型（设备差异）

可能原因 #

• SQLite版本差异：Redmi A1搭载的Android系统版本较低，对应的SQLite版本大概率比Pixel 7 Pro的旧。旧版SQLite在读取NOT NULL约束元数据时存在逻辑差异，导致Room无法正确识别。
• Room校验逻辑差异：不同系统环境下，Room的Schema校验严格度可能存在细微区别，低版本系统触发了更严格的校验规则。
• 外部数据库约束丢失：虽然CREATE语句标记了NOT NULL，但数据库文件生成过程中（比如导出工具的问题）可能导致约束未被正确写入。

解决步骤 #

1. 确认外部数据库的实际约束 #

用SQLite命令行或可视化工具（如DB Browser for SQLite）打开外部数据库文件，执行以下命令查看emojis表结构：

PRAGMA table_info(emojis);

检查输出里notnull列的值是否为1（代表非空）。如果是0，说明数据库文件本身的约束丢失，需要重新生成正确的数据库文件。

2. 调整Room Entity的非空定义（兼容方案） #

如果确认数据库文件的NOT NULL约束存在，但Room仍无法识别，可以在Entity类中显式添加默认值，同时保留@NonNull注解，兼容Room的校验逻辑：

@Entity(tableName = "emojis")
data class EmojiEntity(
    @PrimaryKey(autoGenerate = false)
    @NonNull
    val id: Int = 0,
    @NonNull
    val hex: String = "",
    @NonNull
    val description: String = "",
    @ColumnInfo(name = "group_id")
    @NonNull
    val groupId: Int = 0,
    @ColumnInfo(name = "subgroup_id")
    @NonNull
    val subgroupId: Int = 0
)

注：默认值仅用于Room校验兼容，实际导入的数据库数据仍需保证字段非空。

3. 临时禁用Room Schema校验（不推荐长期使用） #

在Room数据库类的@Database注解中添加exportSchema = false，并在构建实例时启用破坏性迁移 fallback：

@Database(entities = [EmojiEntity::class, GroupEntity::class, SubGroupEntity::class], version = 1, exportSchema = false)
abstract class AppDatabase : RoomDatabase() {
    // DAO定义
}

val db = Room.databaseBuilder(
    context.applicationContext,
    AppDatabase::class.java,
    "your_database_name"
)
    .createFromAsset("your_database_file.db")
    .fallbackToDestructiveMigration()
    .build()

4. 适配低版本SQLite重新添加约束 #

如果是SQLite版本问题，可通过Room的Callback在数据库导入后重新添加约束。由于SQLite不支持直接修改列约束，需要通过临时表迁移数据：

val db = Room.databaseBuilder(...)
    .createFromAsset("your_database_file.db")
    .addCallback(object : RoomDatabase.Callback() {
        override fun onCreate(db: SupportSQLiteDatabase) {
            super.onCreate(db)
            db.execSQL("""
                BEGIN TRANSACTION;
                CREATE TABLE emojis_new (
                    id INTEGER NOT NULL PRIMARY KEY,
                    hex TEXT NOT NULL,
                    description TEXT NOT NULL,
                    group_id INTEGER NOT NULL,
                    subgroup_id INTEGER NOT NULL
                );
                INSERT INTO emojis_new SELECT id, hex, description, group_id, subgroup_id FROM emojis;
                DROP TABLE emojis;
                ALTER TABLE emojis_new RENAME TO emojis;
                COMMIT;
            """.trimIndent())
        }
    })
    .build()

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