SpringBoot 3迁移后Hibernate Repository.save()空指针异常求助

问题复现场景 #

调用继承自JpaRepository的save(entity)方法时抛出空指针异常：

java.lang.NullPointerException: Cannot invoke "org.hibernate.persister.collection.CollectionPersister.getRole()" because "this.loadedPersister" is null

实体包含@OneToMany、@ManyToOne关联字段，仅在更新较多数据的场景下稳定报错，更新少量数据的方法正常。迁移中仅做了以下变更：

• 新增JPA初始化平台配置：

  spring:
    jpa:
      init:
        platform: org.eclipse.persistence.platform.database.PostgreSQLPlatform
  

• 升级Ehcache版本
• 替换hibernate-types-52为hibernate-types-60并适配SqlFunctionContributor（改用PatternBasedSqmFunctionDescriptor替代SQLFunctionTemplate）

排查与解决方案 #

1. 修正JPA初始化平台配置 #

SpringBoot 3.x默认集成Hibernate 6.x，你配置的PostgreSQLPlatform是EclipseLink的类，与Hibernate不兼容，会导致Hibernate内部集合持久化逻辑异常。改为Hibernate对应的方言：

spring:
  jpa:
    init:
      platform: org.hibernate.dialect.PostgreSQLDialect

2. 检查Hibernate Types 60适配完整性 #

虽然你已适配SqlFunctionContributor，但Hibernate 6.x对集合关联、类型处理的逻辑有较大变化：

• 检查实体中使用hibernate-types定义的字段是否适配6.x版本的注解，比如@Type的参数是否变更
• 确认@OneToMany关联的fetch、cascade配置，Hibernate 6.x对懒加载集合的状态校验更严格，避免在更新时操作未初始化的懒加载集合

3. 验证Ehcache版本兼容性 #

确保升级后的Ehcache版本与SpringBoot 3.0.5、Hibernate 6.x兼容：

• SpringBoot 3.x推荐使用Ehcache 3.10+版本，检查依赖管理文件中的版本号
• 检查缓存配置文件中集合缓存的定义，避免缓存配置导致集合加载时无法获取持久化器

4. 规范实体集合字段初始化 #

Hibernate 6.x对空集合的处理更严格，确保实体中的集合字段在实例化时初始化（而非null）：

@Entity
public class YourEntity {
    @OneToMany(mappedBy = "parent", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<ChildEntity> children = new ArrayList<>(); // 初始化空集合，避免null

    // getter/setter
}

更新实体时，避免直接将集合置为null，而是通过clear()、addAll()等方法修改集合内容。

5. 调试定位具体问题集合 #

开启Hibernate的详细日志，定位触发异常的具体集合：

logging:
  level:
    org.hibernate.SQL: DEBUG
    org.hibernate.type.descriptor.sql: TRACE
    org.hibernate.cache: DEBUG

查看报错场景下的SQL执行日志和集合加载日志，确认是哪个关联集合导致loadedPersister为null，针对性调整该集合的配置或更新逻辑。

内容的提问来源于stack exchange，提问作者David Bulko