Hibernate查询触发NullPointerException问题排查与解决求助

问题场景 #

在基于Jakarta EE、Java 17的Spring Boot 3.1.4项目中，调用自定义JPA仓库方法_loadAggregatedOrganizations时，触发Hibernate框架内部的NullPointerException，堆栈信息如下：

java.lang.NullPointerException: Cannot invoke "org.hibernate.sql.ast.spi.SqlAstProcessingState.getSqlExpressionResolver()" because the return value of "org.hibernate.query.sqm.sql.BaseSqmToSqlAstConverter.getCurrentProcessingState()" is null

涉及的仓库方法代码：

@EntityGraph(value = "Organization.loadAggregatedData", type = EntityGraph.EntityGraphType.FETCH)
@Query(value = "SELECT o FROM Organization o where o in :organizations")
List<Organization> _loadAggregatedOrganizations(@Param("organizations") List<? extends Contact> organizations);

已知信息：

• 依赖版本：Hibernate 6.2.13.Final、Spring Data JPA 3.0.9、Spring Framework 6.0.13
• 实体存在复杂继承结构与关联关系
• 降级到javax.*包及对应低版本依赖（如Spring Boot 2.x）时，问题完全消失

根因分析 #

该NullPointerException是Hibernate 6.x版本的已知边缘场景bug，核心触发条件为：

1. JPA查询使用IN子句，且传入参数为带泛型通配符的父类/接口集合（这里是List<? extends Contact>，Organization是Contact的子类）
2. 同时搭配@EntityGraph进行关联数据的批量加载

Hibernate 6.x针对Jakarta EE重构了SQL AST生成与类型处理逻辑，相比Hibernate 5.x（javax版本）对类型校验更严格，但在处理跨类型IN查询+实体图的组合场景时，内部状态维护逻辑出现漏洞，导致getCurrentProcessingState()返回null，进而触发后续空指针调用。

解决建议 #

1. 调整查询参数类型（快速规避） #

如果业务场景允许，将方法参数改为具体的List<Organization>，消除泛型通配符带来的类型歧义：

@EntityGraph(value = "Organization.loadAggregatedData", type = EntityGraph.EntityGraphType.FETCH)
@Query(value = "SELECT o FROM Organization o where o in :organizations")
List<Organization> _loadAggregatedOrganizations(@Param("organizations") List<Organization> organizations);

若必须保留List<? extends Contact>参数，可在调用仓库方法前先过滤出Organization类型的元素：

// 业务代码中调用前过滤
List<Organization> targetOrgs = organizations.stream()
    .filter(Organization.class::isInstance)
    .map(Organization.class::cast)
    .toList();
List<Organization> result = organizationRepository._loadAggregatedOrganizations(targetOrgs);

2. 升级Hibernate/Spring Boot版本（彻底修复） #

该bug已在Hibernate 6.2.14.Final及更高版本中修复，可通过以下两种方式升级：

• 直接升级Hibernate依赖至6.2.14.Final或6.3.x系列
• 升级Spring Boot至3.2.x及以上版本（Spring Boot 3.2.x默认集成Hibernate 6.2.14.Final+）

3. 临时移除实体图（应急方案） #

如果需要快速恢复业务运行，可暂时移除@EntityGraph注解，验证问题是否消失。若问题解决，说明实体图与IN查询的组合是触发bug的关键，后续可结合版本升级再恢复实体图配置。

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