Hibernate查询带sbu/br参数时返回空列表无报错问题排查

遇到这种带关联实体参数时返回空列表、去掉就正常的情况，咱们可以从以下几个方向逐一排查：

1. 关联实体为null导致过滤掉符合条件的记录 #

如果你的TrxCmpComplaint表中存在部分记录的cfgCmpSbu或cfgCmpBranch字段为null，那么cfgCmpSbu.sbuid=:sbu这类条件会直接排除这些记录——因为在SQL/HQL中，null和任何值的比较结果都是false。而当你去掉sbu和br参数时，这些原本被过滤的记录就会被正常返回。

解决办法：如果业务允许关联实体为null，调整HQL条件，增加null判断：

Query q = sess.createQuery("from TrxCmpComplaint where (cfgCmpSbu is null or cfgCmpSbu.sbuid=:sbu) and (cfgCmpBranch is null or cfgCmpBranch.brid=:br) and ((marktousername=:usr or complainantemp=:usr) or dgusername=:usr) ORDER BY statusid asc, CMPID desc");

2. 参数类型与实体/数据库字段不匹配 #

检查实体类中cfgCmpSbu.sbuid和cfgCmpBranch.brid的类型：

• 如果实体中是Integer类型（允许null），但你的DAO方法参数是int（基本类型，不能为null），当数据库中存在sbuid/brid为null的记录时，这些记录会被排除；
• 如果数据库中对应的外键字段是字符串类型（比如CHAR或VARCHAR2），而你传入的是int参数，Oracle会做隐式类型转换，可能导致值不匹配（例如数据库存的是"123 "，int转字符串后是"123"，二者不相等）。

解决办法：

• 把DAO方法的sbu和br参数类型改成Integer，避免基本类型自动拆箱导致的null值处理问题；
• 对照数据库字段类型，确保参数类型与字段类型一致（比如字段是字符串就传String类型）。

3. 查看实际执行的SQL，定位问题根源 #

HQL最终会转换成SQL执行，直接查看生成的SQL是最有效的调试方式。你可以在Hibernate配置中开启SQL日志：

hibernate.show_sql=true
hibernate.format_sql=true

开启后，控制台会打印出实际执行的SQL语句，把你传入的参数代入到SQL中，直接在Oracle客户端（比如PL/SQL Developer）执行，看是否能返回结果。这能快速判断是HQL转换的问题，还是参数数据本身不匹配数据库中的记录。

4. 检查关联映射的正确性 #

确认TrxCmpComplaint实体与CfgCmpSbu、CfgCmpBranch的关联映射是否正确：

• 查看@ManyToOne注解中的@JoinColumn是否指向了正确的数据库外键字段；
• 确保关联实体的主键字段（比如sbuid）与TrxCmpComplaint中的外键字段类型一致。

另外，注意你的catch块只是打印异常但没有抛出，虽然你说没有报错，但可以临时修改catch块，把异常抛出或者打印更详细的信息，避免遗漏潜在的异常（比如类型转换警告）。

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