Hibernate/Spring Data：原生查询下类投影失效问题求助

问题根源 #

Spring Data JPA对接口投影的支持是通过动态生成代理类实现的，能直接适配原生查询结果；但类投影无法自动完成原生查询结果到POJO的转换，必须显式配置结果集映射，否则会抛出ConverterNotFoundException。你之前尝试的命名查询方案出错，是因为注解位置和命名规则不正确。

正确解决方案 #

方案一：用@SqlResultSetMapping+@NamedNativeQuery（推荐） #

步骤1：在实体类上配置结果集映射和命名查询

将@SqlResultSetMapping和@NamedNativeQuery添加到你的Dog实体类上（注意：这两个注解属于JPA实体注解，不能加在非实体类SuperDto上）：

@Entity
@Table(name = "dogs")
// 命名查询的name格式为：Repository接口名.方法名
@NamedNativeQuery(
    name = "DogRepository.withNames",
    query = "SELECT name from dogs",
    resultSetMapping = "SuperDtoMapping"
)
// 定义结果集到SuperDto的映射规则
@SqlResultSetMapping(
    name = "SuperDtoMapping",
    classes = @ConstructorResult(
        targetClass = SuperDto.class,
        columns = @ColumnResult(name = "name") // 对应查询返回的列名
    )
)
public class Dog {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    // 其他字段、getter/setter
}

步骤2：简化Repository方法

不需要在Repository方法上添加@Query，Spring Data会自动匹配命名查询：

public interface DogRepository extends JpaRepository<Dog, Long> {
    List<SuperDto> withNames();
}

方案二：直接在@Query中指定结果集映射 #

如果不想用命名查询，也可以直接在Repository的@Query注解中指定resultSetMapping：

public interface DogRepository extends JpaRepository<Dog, Long> {
    @Query(
        value = "SELECT name from dogs",
        nativeQuery = true,
        resultSetMapping = "SuperDtoMapping"
    )
    List<SuperDto> withNames();
}

同样需要在Dog实体类上配置@SqlResultSetMapping（内容同方案一）。

关键注意事项 #

• @NamedNativeQuery的name必须严格遵循Repository接口名.方法名的格式，否则Spring Data无法匹配到对应的查询。
• SuperDto的构造函数参数顺序必须和查询返回的列顺序完全一致，否则会导致映射失败。
• 确保查询返回的列名和@ColumnResult中指定的name完全匹配（区分大小写，取决于数据库配置）。

为什么接口投影可以正常工作 #

Spring Data会为接口投影动态生成代理类，代理类会直接通过反射调用查询结果的get方法来填充数据，无需额外配置；而类投影需要明确告诉JPA如何将原生查询的结果集转换为POJO实例，因此必须配置结果集映射。

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