JPA createQuery的where条件不生效，查询返回全量记录问题求助

安全阿岳

2026-10-6

排查步骤

1. 确认生成的原生SQL是否包含where条件

开启Hibernate SQL打印配置，验证最终执行的SQL语句是否符合预期：
如果是Spring Boot项目，在application配置文件中添加：

# 打印执行SQL
spring.jpa.show-sql=true
# 格式化SQL便于阅读
spring.jpa.properties.hibernate.format_sql=true
# 打印参数绑定的值
logging.level.org.hibernate.type.descriptor.sql=TRACE

启动项目执行查询后，查看控制台输出的SQL：

如果SQL没有where子句：大概率是实体类注解不规范导致JPQL解析失败，检查@Entity注解是否导入的是正确的包（Jakarta EE项目用jakarta.persistence.Entity，旧Java EE项目用javax.persistence.Entity），确认实体类没有和同包下同名类冲突。
如果SQL有where子句：查看绑定的参数值是否和你传入的regularName一致，确认是否存在参数传空、前后带空格等不匹配问题。如果传入的regularName为null，=判断不会匹配任何值，需要修改JPQL为from FilteredFrameworksDbStructure F where F.regularName is null或者适配null的写法：from FilteredFrameworksDbStructure F where (:regular is null or F.regularName = :regular)。

2. 排查缓存干扰

如果开启了Hibernate二级缓存或查询缓存，可能会返回历史缓存的全量查询结果，临时关闭缓存测试：

spring.jpa.properties.hibernate.cache.use_second_level_cache=false
spring.jpa.properties.hibernate.cache.use_query_cache=false

3. 排查全局过滤器/拦截器影响

检查项目是否配置了全局JPA过滤器、租户隔离拦截器、SQL改写插件等组件，这类组件可能会修改原有查询逻辑，导致where条件被覆盖、失效。

4. 原生SQL对比验证

直接执行原生SQL排查是否是JPQL层的问题：

// 替换原查询逻辑测试
List<FilteredFrameworksDbStructure> result = entityManager
    .createNativeQuery("select * from frameworks_filter where regular_name = :regular", FilteredFrameworksDbStructure.class)
    .setParameter("regular", regularName)
    .getResultList();

如果原生SQL查询结果正确：说明JPQL解析逻辑存在异常，检查实体类字段映射是否和数据库列完全匹配，确认没有拼写错误。
如果原生SQL也返回全量数据：检查数据库表frameworks_filter的regular_name字段值是否全部相同，或者传入的参数值是否能匹配所有行。

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