SpringBoot中如何将Hibernate/JPA联合查询结果映射到非实体类？

你遇到的问题很典型——JpaRepository的泛型参数要求必须是被@Entity标记的受管实体类，而你的Vehicle只是一个普通的DTO（数据传输对象），所以Spring Data JPA会抛出“not managed type”的错误。下面给你几个可行的解决方案，挑适合你的场景来用：

方案1：构造函数映射（适配原生SQL查询） #

如果你的查询是原生SQL（nativeQuery = true），可以通过@SqlResultSetMapping和@ConstructorResult来把查询结果映射到Vehicle类：

步骤1：完善Vehicle的构造函数 #

确保Vehicle有一个和查询返回字段顺序、类型完全匹配的构造函数：

public class Vehicle {
    private String model;
    private BigDecimal price;

    // 必须与查询返回的字段顺序、类型一一对应
    public Vehicle(String model, BigDecimal price) {
        this.model = model;
        this.price = price;
    }

    // 按需添加getter方法
    public String getModel() { return model; }
    public BigDecimal getPrice() { return price; }
}

步骤2：修改Repository的查询定义 #

不要让Repository继承JpaRepository<Vehicle, Long>（因为Vehicle不是实体），可以基于任意一个实体的Repository来定义方法，比如：

public interface CarRepository extends JpaRepository<Car, Long> {

    @Query(
        value = "SELECT model, price FROM car UNION SELECT model, price FROM motorcycle",
        nativeQuery = true,
        resultSetMapping = "VehicleMapping"
    )
    List<Vehicle> searchVehicles();
}

步骤3：定义结果集映射规则 #

在任意一个实体类上（比如Car）添加@SqlResultSetMapping，告诉JPA如何把查询结果映射到Vehicle：

@Entity
@SqlResultSetMapping(
    name = "VehicleMapping",
    classes = @ConstructorResult(
        targetClass = Vehicle.class,
        columns = {
            @ColumnResult(name = "model", type = String.class),
            @ColumnResult(name = "price", type = BigDecimal.class)
        }
    )
)
public class Car {
    // 你的Car实体字段、注解及逻辑
}

方案2：接口投影（最简洁的实现方式） #

如果不需要完整的Vehicle类对象，也可以用接口投影来接收结果，省去构造函数的编写：

步骤1：定义投影接口 #

接口的方法名要和查询返回的字段名对应（驼峰转下划线的映射规则JPA会自动处理）：

public interface VehicleProjection {
    String getModel();
    BigDecimal getPrice();
}

步骤2：修改Repository方法 #

同样基于实体Repository定义方法，直接返回投影接口的列表：

public interface CarRepository extends JpaRepository<Car, Long> {

    @Query(
        value = "SELECT model, price FROM car UNION SELECT model, price FROM motorcycle",
        nativeQuery = true
    )
    List<VehicleProjection> searchVehicles();
}

Spring Data JPA会自动生成这个接口的代理实现，把查询结果映射到接口的getter方法上。

方案3：JPQL构造函数调用（适配JPQL查询） #

如果把原生SQL改成JPQL，也可以直接在查询语句里调用Vehicle的构造函数：

步骤1：确保Vehicle有匹配的构造函数 #

和方案1的第一步一致，要有与查询字段对应的构造函数。

步骤2：编写JPQL查询 #

注意要写Vehicle的全限定类名，且UNION前后两个查询的返回字段数量、类型必须完全一致：

public interface CarRepository extends JpaRepository<Car, Long> {

    @Query(
        value = "SELECT new com.yourpackage.Vehicle(c.model, c.price) FROM Car c " +
                "UNION " +
                "SELECT new com.yourpackage.Vehicle(m.model, m.price) FROM Motorcycle m"
    )
    List<Vehicle> searchVehicles();
}

关键注意点 #

• 绝对不要让Repository继承JpaRepository<Vehicle, Long>，因为Vehicle不是实体类，Spring Data JPA无法对它进行持久化管理。
• 无论用哪种方案，查询返回的字段数量、类型必须和接收类/接口的属性完全匹配，否则会出现映射失败的问题。

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