Spring Data JPA查询返回多条CPC记录而非单条的问题求助

核心问题 #

你的查询在数据库工具中能得到正确结果，但Spring返回所有CPC记录还触发额外查询，根源有两点：

• 你返回的是CustomerEntity，该实体包含@OneToMany关联的cpcEntityList和xeroEntityList。即使原生查询只查询了部分CPC和机器数据，Hibernate在后续操作（如JSON序列化、访问集合）时会触发懒加载查询，把该客户所有的机器和CPC全量查出，这就是你看到的额外两条Hibernate查询。
• 原生查询返回的是多条「客户+最新CPC+机器」的结果，但Hibernate会将这些结果合并为一个CustomerEntity实例，同时把该客户所有关联的CPC填充到cpcEntityList中，而非仅保留查询出来的最新记录。

解决方案 #

方案1：使用DTO接收查询结果（推荐） #

创建专门的DTO类承载所需数据，彻底规避实体关联带来的自动加载问题：

1. 定义DTO类：

public class CustomerCpcDto {
    private int customerId;
    private String customerName;
    private String customerEmail;
    private int cpcId;
    private Date settlementDate;
    private int machineId;
    private String machineModel;
    private String machineColor;

    // 构造函数参数顺序需与查询结果列顺序完全一致
    public CustomerCpcDto(int customerId, String customerName, String customerEmail,
                          int cpcId, Date settlementDate, int machineId,
                          int machineId2, String machineModel, String machineColor) {
        this.customerId = customerId;
        this.customerName = customerName;
        this.customerEmail = customerEmail;
        this.cpcId = cpcId;
        this.settlementDate = settlementDate;
        this.machineId = machineId;
        this.machineModel = machineModel;
        this.machineColor = machineColor;
    }

    // 按需添加Getter方法
}

2. 修改仓库方法返回DTO列表：

@Query(value = "SELECT k.ID_KLIENT, k.NAZWA, k.EMAIL, " +
        "c.ID_CPC , c.DATA_ROZLICZENIA, c.ID_MASZYNA, " +
        "m.ID_MASZYNA, m.MODEL, m.KOLOR " +
        "FROM KLIENCI k " +
        "JOIN CPC c ON c.ID_KLIENT = k.ID_KLIENT " +
        "JOIN MASZYNY m ON m.ID_KLIENT = k.ID_KLIENT AND m.ID_MASZYNA = c.ID_MASZYNA " +
        "WHERE c.DATA_ROZLICZENIA = (" +
        "   SELECT MAX (c2.DATA_ROZLICZENIA)" +
        "   FROM CPC c2 " +
        "   WHERE c2.ID_KLIENT = k.ID_KLIENT AND c2.ID_MASZYNA = c.ID_MASZYNA " +
        ") AND k.ID_KLIENT = :customerId",
        nativeQuery = true)
List<CustomerCpcDto> findLatestCpcForCustomer(@Param("customerId") int customerId);

这种方式下Hibernate只会执行你编写的原生查询，不会触发额外懒加载，返回结果就是每台机器对应的最新CPC记录。

方案2：调整实体关联与查询（仅当必须返回实体时使用） #

如果业务要求必须返回CustomerEntity，可尝试以下调整：

1. 在CustomerEntity的cpcEntityList上添加@Where注解，过滤出最新CPC记录：

@JsonManagedReference
@OneToMany(mappedBy = "customerEntity", fetch = FetchType.LAZY)
@Where(clause = "DATA_ROZLICZENIA = (SELECT MAX(DATA_ROZLICZENIA) FROM CPC WHERE ID_MASZYNA = ID_MASZYNA AND ID_KLIENT = ID_KLIENT)")
private List<CPCEntity> cpcEntityList;

但这种方式逻辑固定，无法动态适配参数，且可能存在性能隐患，仅适用于简单场景。

2. 配合@Fetch(FetchMode.JOIN)强制关联查询，但需用JPQL精准控制返回的CPC记录，这种方式依然可能因实体映射逻辑导致结果不符合预期，不推荐。

额外说明 #

你的原生SQL逻辑本身是正确的（每台机器取最新CPC），问题完全出在实体映射的关联集合自动加载上。使用DTO是最直接、最可靠的解决方案，它只获取你需要的数据，不涉及实体关联的自动加载逻辑。

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