JPA查询返回重复数据问题求助（SQL约束场景）

嘿，这个问题我之前帮同事排查过类似的，咱们一步步拆解原因和解决方案：

1. 子查询的冗余关联导致重复匹配值 #

你的子查询里同时关联了OfficeLocation和OfficeProfile，这会让子查询返回重复的asccode值（比如同一个asccode对应多条OfficeProfile记录时），主查询用in匹配这些重复值后，再加上实体关联的笛卡尔积影响，就会返回重复的实体对象。

优化方案：将子查询改为exists逻辑 #

去掉子查询里冗余的OfficeProfile关联，改用exists判断关联关系，这样子查询不会返回重复值，主查询逻辑更简洁：

@Query("select distinct profile from OfficeProfile profile where exists " +
       "(select 1 from OfficeLocation ol where ol.statecode = :stateCode and ol.asccode = profile.fcoDesignCd)")
public List<OfficeProfile> searchStateASC(@Param("stateCode") String stateCode);

2. 实体关联的FetchType触发笛卡尔积 #

如果OfficeProfile实体里有@OneToMany这类关联属性，且默认是FetchType.EAGER（比如关联了子表数据），Hibernate执行查询时会自动做关联查询，产生笛卡尔积。这时候即使SQL层面是distinct，JPA会因为实体的关联集合内容不同，把它们判定为不同对象，导致重复返回。

优化方案： #

• 优先把关联属性的FetchType改为LAZY（这是JPA推荐的默认做法，除非你确定每次都需要加载关联数据）：

  @OneToMany(mappedBy = "profile", fetch = FetchType.LAZY)
  private List<RelatedEntity> relatedEntities;
  

• 如果确实需要在这个查询里加载关联数据，用fetch join结合distinct强制JPA去重：

  @Query("select distinct profile from OfficeProfile profile left join fetch profile.relatedEntities where exists " +
         "(select 1 from OfficeLocation ol where ol.statecode = :stateCode and ol.asccode = profile.fcoDesignCd)")
  public List<OfficeProfile> searchStateASC(@Param("stateCode") String stateCode);
  

3. 实体的equals/hashCode方法未正确实现 #

JPA的distinct是基于实体的equals()和hashCode()来判断对象是否重复的。如果你的OfficeProfile没正确实现这两个方法（比如没基于主键判断），即使数据库里是同一条记录，JPA也会把它们视为不同对象，导致重复返回。

优化方案： #

确保OfficeProfile的equals()和hashCode()基于主键字段实现，示例：

@Override
public boolean equals(Object o) {
    if (this == o) return true;
    if (o == null || getClass() != o.getClass()) return false;
    OfficeProfile that = (OfficeProfile) o;
    return Objects.equals(id, that.id);
}

@Override
public int hashCode() {
    return Objects.hash(id);
}

4. 原生SQL兜底方案 #

如果上面的方法都没解决问题，可以直接用原生SQL查询，让数据库层面直接做去重：

@Query(value = "select distinct * from office_profile where fco_design_cd in " +
               "(select ol.asccode from office_location ol where ol.statecode = :stateCode)",
       nativeQuery = true)
public List<OfficeProfile> searchStateASC(@Param("stateCode") String stateCode);

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