升级Spring Boot 3后Spring Data R2dbc更新操作失败求助

问题根源 #

升级后Spring Data R2dbc在处理返回Flow<PostSummary>的自定义查询时，错误地将仅包含id、title字段的查询结果尝试映射到带有非空content的Post实体类，触发MappingInstantiationException。核心原因是框架未正确识别目标DTO类型，默认回退到实体类进行映射。

正确解决方法 #

方法1：通过@Query明确指定返回类型 #

在Repository的自定义查询方法上，给@Query注解添加returnType参数，明确指定要映射的DTO类PostSummary，强制框架将结果映射到DTO而非实体类。

示例代码：

interface PostRepository : ReactiveCrudRepository<Post, Long> {
    @Query(
        value = "SELECT id, title FROM posts WHERE title LIKE :title",
        returnType = PostSummary::class
    )
    fun findByTitleContains(title: String): Flow<PostSummary>
}

同时确保PostSummary拥有匹配查询字段的构造函数：

data class PostSummary(val id: Long, val title: String)

方法2：使用投影接口替代数据类 #

定义仅包含所需字段的投影接口，Spring Data R2dbc会自动生成代理类实现该接口并映射查询结果，无需手动处理构造函数，也不会触发实体类的映射逻辑。

示例代码：

interface PostSummary {
    fun getId(): Long
    fun getTitle(): String
}

interface PostRepository : ReactiveCrudRepository<Post, Long> {
    @Query("SELECT id, title FROM posts WHERE title LIKE :title")
    fun findByTitleContains(title: String): Flow<PostSummary>
}

方法3：验证查询SQL与DTO字段匹配 #

确保自定义查询的SELECT字段完全覆盖DTO的所有非空属性，避免因字段缺失导致映射失败。同时检查Repository方法的返回类型是否严格指定为Flow<PostSummary>，消除类型歧义。

注意事项 #

不要为临时解决问题将Post实体的content设为可空，这会破坏数据模型的完整性约束，违背业务设计初衷。

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