Spring Boot JPA Repository用@Query查询指定字段映射至实体的方法

你当前的JPQL查询返回的是Object[]数组（每个数组对应一行数据，元素依次是查询的roleId和name），但方法声明返回List<Role>，Spring Data JPA没有默认转换器能把数组直接转换成Role实体，所以抛出转换异常。另外注意：JPQL操作的是实体类，FROM后面应该写实体类名Role，不是数据库表名role。

以下两种方案都能满足你的需求，将查询字段映射到Role实体（未查询的字段会设为null）：

方案一：使用实体构造器表达式 #

这是最直接的方式，让JPQL直接创建Role实例：

1. 给Role实体添加一个包含roleId和name参数的构造方法，同时保留JPA要求的无参构造器：

public class Role {
    private Long roleId;
    private String name;
    // 其他字段...

    // 新增带指定字段的构造器
    public Role(Long roleId, String name) {
        this.roleId = roleId;
        this.name = name;
    }

    // 必须保留无参构造器，JPA需要用它实例化对象
    public Role() {}

    // getter、setter方法...
}

2. 修改Repository中的@Query语句，使用new关键字调用构造器（注意要写全实体类的完整路径）：

@Repository
public interface RoleRepo extends JpaRepository<Role, Long>{
    @Query("SELECT new demo.model.Role(r.roleId, r.name) FROM Role r")
    List<Role> getAllRoleNames();
}

执行这个查询时，JPA会通过指定的构造器创建Role对象，只填充查询到的roleId和name，其余字段保持null。

方案二：使用接口投影（无需修改实体类） #

如果不想改动Role实体，可以用投影接口来承接查询结果，之后再手动转成Role实体：

1. 定义一个投影接口，只声明需要的字段的get方法：

public interface RoleProjection {
    Long getRoleId();
    String getName();
}

2. 修改Repository的返回类型为List<RoleProjection>：

@Repository
public interface RoleRepo extends JpaRepository<Role, Long>{
    @Query("SELECT r.roleId, r.name FROM Role r")
    List<RoleProjection> getAllRoleNames();
}

调用方法后，Spring Data JPA会生成代理类实现这个接口，返回包含指定字段的对象。如果需要转成Role实体，可以遍历投影列表，逐个赋值：

List<RoleProjection> projections = roleRepo.getAllRoleNames();
List<Role> roles = projections.stream()
    .map(p -> {
        Role role = new Role();
        role.setRoleId(p.getRoleId());
        role.setName(p.getName());
        return role;
    })
    .collect(Collectors.toList());

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