Spring Data JPA中@Query查询返回Object而非Flight类型问题排查

定义了继承自PagingAndSortingRepository的FlightRepository接口，其中querySearchFormFlights方法通过@Query指定查询Flight实体的部分字段，返回类型声明为Page<Flight>，但调用后返回的是Object数组列表而非预期的Flight对象。

Repository代码：

@Repository
public interface FlightRepository extends PagingAndSortingRepository<Flight,Integer> {
    @Query("select f.flightId,f.fromAirport,f.toAirport,f.departure,f.arrival from Flight f")
    Page<Flight> querySearchFormFlights(PageRequest request);
}

测试类代码：

@SpringBootTest
class AirportApplicationTests {

    @Autowired
    private FlightRepository flightRepository;

    @Test
    void contextLoads() {
        List<Flight> flights=flightRepository.querySearchFormFlights(PageRequest.of(0,20)).getContent();
    }
}

输出结果：

[[Ljava.lang.Object;@4ed7db72, [Ljava.lang.Object;@7018636a, [Ljava.lang.Object;@3e866323, [Ljava.lang.Object;@73624529, [Ljava.lang.Object;@31e1c7c, [Ljava.lang.Object;@30ae3c46, [Ljava.lang.Object;@3dbcde0b, [Ljava.lang.Object;@5c168f98, [Ljava.lang.Object;@2f98859a, [Ljava.lang.Object;@6e95c023]

你在JPQL中明确指定查询Flight的多个单独字段，而非整个实体对象。Spring Data JPA在处理这种查询时，会将每一行查询结果封装成一个Object[]数组，数组中的元素顺序与你select的字段顺序一一对应。虽然你声明返回类型是Page<Flight>，但JPA无法自动将零散的字段值组装成完整的Flight实体，运行时实际返回的是Page<Object[]>，所以最终得到的是Object数组列表。

有三种常见的解决方式，可根据需求选择：

1. 查询完整实体对象 #

如果不需要限制返回字段，直接修改JPQL查询整个实体：

@Query("select f from Flight f")
Page<Flight> querySearchFormFlights(PageRequest request);

这样JPA会返回完整的Flight实体对象，与你声明的返回类型匹配。

2. 使用构造函数投影 #

在Flight实体类中添加与查询字段匹配的构造函数：

public class Flight {
    // 原有字段和无参构造
    private Integer flightId;
    private String fromAirport;
    private String toAirport;
    private LocalDateTime departure;
    private LocalDateTime arrival;

    // 新增对应参数的构造函数
    public Flight(Integer flightId, String fromAirport, String toAirport, LocalDateTime departure, LocalDateTime arrival) {
        this.flightId = flightId;
        this.fromAirport = fromAirport;
        this.toAirport = toAirport;
        this.departure = departure;
        this.arrival = arrival;
    }

    // 原有getter/setter
}

然后修改JPQL，通过new关键字调用该构造函数（注意要写全实体类的完整包路径）：

@Query("select new com.yourpackage.Flight(f.flightId,f.fromAirport,f.toAirport,f.departure,f.arrival) from Flight f")
Page<Flight> querySearchFormFlights(PageRequest request);

这样JPA会通过构造函数创建Flight对象并返回。

3. 使用接口投影 #

定义一个投影接口，包含查询字段对应的getter方法：

public interface FlightProjection {
    Integer getFlightId();
    String getFromAirport();
    String getToAirport();
    LocalDateTime getDeparture();
    LocalDateTime getArrival();
}

然后修改Repository方法的返回类型为Page<FlightProjection>：

@Query("select f.flightId,f.fromAirport,f.toAirport,f.departure,f.arrival from Flight f")
Page<FlightProjection> querySearchFormFlights(PageRequest request);

调用方法后会返回实现该接口的代理对象，可通过接口方法获取对应字段值，这种方式无需修改实体类。

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