Android Room Database实现批量更新的正确语法是什么？

错误原因 #

你原有写法的问题在于Room不支持直接将自定义数据类的List<MyTuple>自动解析为VALUES子句需要的多组参数结构，它无法识别自定义MyTuple类的内部字段完成参数展开，因此会在AS (VALUES(:mmdTuples))位置报错。

正确实现方案 #

方案1：使用Room原生@Update注解实现（推荐）

这是最符合Room设计规范的实现方式，无需手动编写SQL，Room会自动按主键匹配完成批量更新，且内部自带事务优化。

1. 首先调整MyTuple类，给主键字段加@PrimaryKey注解：

data class MyTuple(    
    @PrimaryKey @ColumnInfo(name = "uuid") var uuid: String,
    @ColumnInfo(name = "body") var body: SpannableStringBuilder,
    @ColumnInfo(name = "mention_metadata_list") var mentionMetaDataList: List<MentionsMetaData>? = ArrayList<MentionsMetaData>()
)

2. DAO层直接用@Update注解，指定对应的表实体类：

@Dao
abstract class ChatDao {
    // entity参数填写你实际的Messages表对应的实体类
    @Update(entity = Messages::class)
    abstract fun bulkUpdateBodyAndMetaDataForGroupMessages(mmdTuples: List<MyTuple>): Int
}

调用时直接传入修改后的List<MyTuple>即可，Room会自动按uuid匹配要更新的行，只修改你在MyTuple中定义的两个字段，其他字段不会被覆盖。

方案2：自定义SQL实现（适用于有特殊更新逻辑的场景）

如果你需要自定义SQL逻辑，可以封装一个工具方法自动生成SQL语句和绑定参数，避免手动拼SQL的风险，对外仍然可以直接传入List<MyTuple>使用：

@Dao
abstract class ChatDao {
    @RawQuery
    abstract fun bulkUpdateByRawQuery(query: SimpleSQLiteQuery): Int

    // 封装对外暴露的方法，自动处理参数拼接
    fun bulkUpdateBodyAndMetaDataForGroupMessages(mmdTuples: List<MyTuple>) {
        if (mmdTuples.isEmpty()) return
        // 生成VALUES后的占位符：(?, ?, ?), (?, ?, ?)...
        val placeholders = mmdTuples.joinToString(",") { "(?, ?, ?)" }
        val sql = """
            WITH temp_table(id, new_body, mmd_list) AS (VALUES $placeholders)
            UPDATE messages 
            SET 
                body = (SELECT new_body FROM temp_table WHERE temp_table.id == messages.uuid), 
                mention_metadata_list = (SELECT mmd_list FROM temp_table WHERE temp_table.id == messages.uuid) 
            WHERE uuid IN (SELECT id FROM temp_table)
        """.trimIndent()
        // 按顺序填充参数
        val args = arrayListOf<Any?>()
        mmdTuples.forEach {
            args.add(it.uuid)
            args.add(it.body)
            args.add(it.mentionMetaDataList)
        }
        bulkUpdateByRawQuery(SimpleSQLiteQuery(sql, args.toArray()))
    }
}

内容的提问来源于stack exchange，提问作者Qazi Fahim Farhan