Spring Boot JPA原生查询返回PGObject而非实体，如何解决？

你在使用PostgreSQL的Spring Boot JPA原生查询时，遇到了返回结果为PGObject而非目标实体的问题，以下是几种可行的解决方式：

1. 构造DTO映射（最稳妥的类型安全方案） #

这是JPA处理多实体+自定义计算字段返回的标准方式，实现成本很低：

• 先创建一个DTO类，包含目标返回字段的参数化构造函数：

public class ClubDistanceDTO {
    private ClubAddress clubAddress;
    private Club club;
    private double distance;

    // 必须与查询返回字段顺序一致
    public ClubDistanceDTO(ClubAddress clubAddress, Club club, double distance) {
        this.clubAddress = clubAddress;
        this.club = club;
        this.distance = distance;
    }

    // 按需添加getter/setter
}

• 修改原生查询，使用NEW关键字指定DTO的全类名：

SELECT NEW com.your.package.ClubDistanceDTO(clubAddress, club, point(?1, ?2) <@> (point(clubAddress.longitude, clubAddress.latitude)::point)) 
FROM club_address clubAddress, club_club club 
WHERE club.id = clubAddress.club_id

• 在Repository接口中定义方法，返回DTO列表：

@Query(value = "上述SQL语句", nativeQuery = true)
List<ClubDistanceDTO> findClubsWithDistance(double targetLon, double targetLat);

2. 使用Tuple手动提取结果（无需额外类） #

如果不想创建DTO，可以让查询返回Tuple，再手动从元组中提取实体和数值：

• Repository方法定义：

@Query(value = "你的原生SQL语句", nativeQuery = true)
List<Tuple> findClubsWithDistance(double targetLon, double targetLat);

• 业务代码中提取数据：

List<Tuple> results = clubRepository.findClubsWithDistance(targetLon, targetLat);
for (Tuple tuple : results) {
    ClubAddress clubAddress = (ClubAddress) tuple.get(0);
    Club club = (Club) tuple.get(1);
    double distance = ((Number) tuple.get(2)).doubleValue();
    // 后续业务处理
}

注意：这种方式依赖JPA自动类型转换，部分复杂场景可能需要手动处理PGObject到实体的转换，稳定性不如DTO方案。

3. 实体关联+投影接口（适合已定义实体关联的场景） #

如果Club和ClubAddress实体类中已经定义了关联关系（比如Club有@OneToMany关联ClubAddress），可以用投影接口简化返回：

• 创建投影接口，方法名需与查询返回的别名对应：

public interface ClubWithDistanceProjection {
    Club getClub();
    ClubAddress getClubAddress();
    double getDistance();
}

• 修改查询语句，为返回字段指定别名：

SELECT club AS club, clubAddress AS clubAddress, point(?1, ?2) <@> (point(clubAddress.longitude, clubAddress.latitude)::point) AS distance 
FROM club_address clubAddress, club_club club 
WHERE club.id = clubAddress.club_id

• Repository方法返回投影列表：

@Query(value = "上述SQL语句", nativeQuery = true)
List<ClubWithDistanceProjection> findClubsWithDistance(double targetLon, double targetLat);

核心原因说明 #

原生查询默认返回JDBC原始对象（如PGObject），JPA无法自动将其映射为自定义实体类，必须通过显式的映射规则（DTO、Tuple、投影）来完成转换。其中DTO方案类型安全、可读性强，是最推荐的生产级解决方案。

内容的提问来源于stack exchange，提问作者Sebastian G.