Room Database报Parameter specified as non-null is null错误如何插入空对象

你遇到的Parameter specified as non-null is null报错，本质是Room原生不支持直接存储自定义复杂数据类型（你这里的Profile类），即使你将该字段声明为可空类型Profile?，Room也没有默认的类型转换器实现复杂对象和SQLite支持存储的基础类型（比如String、Blob等）之间的转换，导致数据插入时字段映射逻辑异常抛出空参数错误。

你需要通过Room的TypeConverter实现自定义类型转换，将Profile对象和可空的JSON字符串互转，就可以正常插入null值了，具体步骤如下：

• 第一步：编写自定义类型转换器类

import androidx.room.TypeConverter
import com.google.gson.Gson
import com.google.gson.reflect.TypeToken

class ProfileTypeConverter {
    @TypeConverter
    fun fromProfile(profile: Profile?): String? {
        // profile为null时直接返回null，Room会自动存储null值到对应字段
        return profile?.let { Gson().toJson(it) }
    }

    @TypeConverter
    fun toProfile(profileJson: String?): Profile? {
        // 读取到的JSON为null时直接返回null
        return profileJson?.let { 
            Gson().fromJson(it, object : TypeToken<Profile>() {}.type) 
        }
    }
}

• 第二步：在Database类上添加转换器注解
  在你继承RoomDatabase的实现类上添加@TypeConverters注解，注册上面写的转换器：

import androidx.room.Database
import androidx.room.RoomDatabase
import androidx.room.TypeConverters

@Database(entities = [User::class], version = 1)
@TypeConverters(ProfileTypeConverter::class) // 注册转换器
abstract class AppDatabase : RoomDatabase() {
    // 你的Dao声明
    abstract fun userDao(): UserDao
}

• 第三步：验证插入逻辑
  完成上面两步后，你就可以正常插入profile字段为null的User对象了，Room会自动将null值存储到对应表字段中，不会再抛出非空参数错误。

• 如果你后续调整了Profile类的结构，注意做数据库版本升级，避免新旧数据转换异常
• 如果你不希望用JSON序列化存储，也可以考虑将Profile拆成单独的关联表，通过外键和User表关联，不过这种方案实现成本更高，适合需要单独查询Profile数据的场景

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