Android Room：如何避免用Null覆盖已有非空属性？

代码示例 #

class ArticleResponse(
    val id: Int,
    val previewContent: String
)

fun ArticleResponse.mapToEntity() = Article(
    id = id,
    previewContent = previewContent,
    content = null
)

class SingleArticleResponse(
    val id: Int,
    val content: String
)

fun SingleArticleResponse.mapToEntity() = Article(
    id = id,
    previewContent = null,
    content = content
)

@Entity(tableName = "articles")
class Article(
    @PrimaryKey
    @ColumnInfo(name = "id")
    val id: Int,

    @ColumnInfo(name = "preview_content")
    val previewContent: String?,

    @ColumnInfo(name = "content")
    val content: String?
)

场景说明 #

调用API接口X会返回ArticleResponse列表，该响应不包含content属性；调用API接口Y查看单篇文章时，返回SingleArticleResponse，该响应不包含previewContent属性。

问题 #

无论执行哪种操作，本地数据库中Article实体的content或previewContent总有一个属性为Null。

解决方案 #

Room本身没有内置配置项直接实现“非空属性不被Null覆盖”的功能，需要通过手动处理数据合并来解决，以下是两种常用方案：

方案1：Repository层先查后合并再更新 #

在数据仓库层先查询数据库中已有的对应记录，将新数据的非Null属性与已有数据的非Null属性合并，再执行插入/更新操作：

// Repository中的示例方法
suspend fun upsertArticle(newArticle: Article) {
    // 查询数据库中已有的文章
    val existingArticle = articleDao.getArticleById(newArticle.id)
    // 合并属性：新数据为Null的字段，用已有数据的对应值填充
    val mergedArticle = Article(
        id = newArticle.id,
        previewContent = newArticle.previewContent ?: existingArticle?.previewContent,
        content = newArticle.content ?: existingArticle?.content
    )
    // 执行Upsert操作（Room 2.4+支持@Upsert，自动处理插入/更新冲突）
    articleDao.upsert(mergedArticle)
}

// DAO接口定义
@Dao
interface ArticleDao {
    @Upsert
    suspend fun upsert(article: Article)

    @Query("SELECT * FROM articles WHERE id = :id")
    suspend fun getArticleById(id: Int): Article?
}

方案2：使用SQL局部更新 #

通过自定义SQL语句，利用COALESCE函数实现只更新非Null字段，无需提前查询实体：

@Dao
interface ArticleDao {
    @Query("""
        UPDATE articles 
        SET preview_content = COALESCE(:previewContent, preview_content),
            content = COALESCE(:content, content)
        WHERE id = :id
    """)
    suspend fun updateArticleFields(id: Int, previewContent: String?, content: String?)
}

COALESCE函数会优先使用第一个非Null参数值，若第一个参数为Null则保留原有字段值，直接通过SQL完成局部更新，效率更高。

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