Spring Boot 3+Hibernate 6迁移遇EntityKey空指针问题求解决方案

我们正在将遗留应用从Spring Boot 2.7迁移至3.0.2，同步升级到Hibernate 6。运行应用时触发如下空指针异常：

java.lang.NullPointerException: 
Cannot invoke "org.hibernate.engine.spi.EntityKey.getIdentifier()" because "this.entityKey" is null

项目的persistence.xml中JPA提供者配置为：

<provider>org.hibernate.jpa.HibernatePersistenceProvider</provider>

依赖配置包含Spring Boot JPA starter：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

查询到Hibernate官方工单显示该问题已在Hibernate 6.1.7中修复，于是我们在POM中添加了以下依赖并重新构建，但问题仍未解决：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.1.7.Final</version>
    <type>pom</type>
</dependency>

更新：已定位问题出现在复合主键场景中，排查确认所有主键字段均非空，但复合主键仍会触发该错误，求其他可行解决方案？

可行解决方案 #

1. 修正Hibernate依赖的引入方式 #

当前添加的hibernate-core依赖使用了<type>pom</type>，这会导致依赖无法正确引入（pom类型为父依赖，并非可执行jar包）。需移除该类型声明，确保引入的是有效jar：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.1.7.Final</version>
</dependency>

同时建议通过Spring Boot的依赖管理统一版本，避免版本冲突：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.hibernate.orm</groupId>
            <artifactId>hibernate-core</artifactId>
            <version>6.1.7.Final</version>
        </dependency>
    </dependencies>
</dependencyManagement>

2. 检查复合主键的映射配置 #

Hibernate 6对复合主键的映射要求更严格，需确保：

• 复合主键类（@Embeddable）必须重写equals()和hashCode()方法，逻辑需覆盖所有主键字段
• 实体类使用@EmbeddedId或@IdClass时，主键字段与数据库列的映射完全匹配
• 若使用@IdClass，主键类必须实现Serializable接口

示例正确的@Embeddable复合主键：

@Embeddable
public class CompositePK implements Serializable {
    private Long id1;
    private String id2;

    // 构造方法、getter/setter

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

    @Override
    public int hashCode() {
        return Objects.hash(id1, id2);
    }
}

3. 排查实体生命周期中的主键初始化 #

确保在执行save()、merge()等持久化操作前，复合主键的所有字段已完成初始化。可在业务代码中添加前置校验，避免Hibernate生成EntityKey时出现空值。

4. 升级至更高版本的Hibernate #

若上述方法无效，可尝试升级到Hibernate 6.2.x及以上版本，后续版本修复了更多复合主键相关的兼容性问题，可能覆盖当前场景的bug。

内容的提问来源于stack exchange，提问作者gene b.