Spring Data查询返回null但SQL查询有结果的问题排查

一、相关代码 #

1. 持久化类Region #

@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@SuperBuilder
@Entity
@Table(name = "REGION")
@NamedQueries({
    @NamedQuery(name = IRegionRepo.QUERY_NAME.findPropertyValue, query = IRegionRepo.QUERY.findPropertyValue)
})
public class Region extends NameClassifier {

    /** The Constant serialVersionUID. */
    private static final long serialVersionUID = 1L;

    /** The countries. */
    @OneToMany
    @JoinTable(name = "REGION_COUNTRY", joinColumns = @JoinColumn(name = "REGION"), inverseJoinColumns = @JoinColumn(name="COUNTRY"))
    private Set<Country> countries;

    /** The properties. */
    @ElementCollection
    @JoinTable(name = "REGION_PROPERTY", joinColumns = @JoinColumn(name = "REGION"))
    @MapKeyColumn(name = "PROPERTY_NAME")
    @Column(name = "PROPERTY_VALUE")
    private Map<String, String> properties;
}

2. Spring Data仓库查询代码 #

public final static String findPropertyValue = "select VALUE(rp) from Region r join r.properties rp "
            + "where :country MEMBER OF r.countries and KEY(rp)=:property";

@Query(name = QUERY_NAME.findPropertyValue)
public String findTopPropertyValue(@Param("country") final Country country, @Param("property") final String property);

3. 生成的SQL语句 #

select properties1_.property_value as col_0_0_ 
from region region0_ inner join region_property properties1_ on  region0_.id=properties1_.region 
where (? in (select countries2_.country from region_country countries2_ where region0_.id=countries2_.region)) and properties1_.property_name=?;

二、问题现象 #

调用findTopPropertyValue方法传入特定参数时返回null，但将上述生成的SQL代入相同参数在SQL*Plus中执行，却能得到预期结果。

三、可能的原因及排查方向 #

• Country对象的相等性判断问题：
  JPA处理MEMBER OF条件时，依赖对象的equals()和hashCode()方法。如果Country类没有按业务主键（比如id字段）重写这两个方法，默认会比较对象内存地址，即使数据库中存在对应关联记录，也会判定传入的Country对象不在关联集合中，导致查询无结果。检查Country类的这两个方法实现。
• 参数绑定的实际值不符：
  手动执行SQL时可能直接传入了Country的id值，但JPA绑定的是整个Country对象。开启Hibernate的SQL日志（如show_sql和format_sql），查看实际绑定的参数值是否为Country的id，确认参数是否正确传递到SQL中。
• 结果映射的隐性问题：
  虽然SQL返回了值，但可能存在字段类型不匹配、数据库字段包含不可见字符（如空格、换行）等情况，导致JPA无法正确映射为String类型的结果。检查REGION_PROPERTY表的property_value字段类型是否与实体中properties的String类型兼容，同时查看返回值是否有特殊字符。
• 事务或缓存干扰：
  当前查询可能处于未提交的事务中，或者Hibernate一级缓存中存在旧数据，导致查询结果被缓存覆盖。尝试在新的事务中执行查询，或者调用entityManager.clear()清空缓存后再执行。
• findTop关键字的潜在影响：
  方法名中的findTop可能让Spring Data JPA在处理结果时做了额外的限制逻辑，虽然生成的SQL看起来正常，但实际执行时可能过滤了结果。可以尝试去掉Top，将方法名改为findPropertyValue，再测试是否能返回结果。

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