使用JPA结合Hibernate查询数据时随机出现NullPointerException问题求助

开发者阿泽

2026-4-30

解决Hibernate事务中查询时随机触发的NullPointerException问题

从你描述的场景和异常栈来看，这个随机出现的NPE是Hibernate在自动刷新（auto-flush）持久化上下文时抛出的，而且只在生产环境出现，大概率和未完全初始化的实体触发了auto-flush有关。先梳理下你的场景和可能的解决方向：

问题场景回顾

你的事务方法逻辑是：

@Transactional
public void saveData(){
    A a = new A();
    a.setXX("xx");
    // 这里查询B时触发异常
    B b = bRepository.findFirstByImei("xxx");
    // 其他逻辑
    aRepository.save(a);
}

异常栈指向Hibernate的AbstractFlushingEventListener.prepareEntityFlushes方法，说明在查询B之前，Hibernate触发了auto-flush（默认情况下，Hibernate会在执行查询前刷新所有待处理的实体变更），而此时你创建的实体A还未完全初始化，导致flush时出现NPE。

可能的原因

实体A存在未设置的非空属性：实体A可能有数据库层面或JPA标注的非空约束属性（比如@Column(nullable = false)），你只设置了xx属性，其他必填属性未赋值。本地环境可能因为数据或会话上下文的差异没触发这个问题，但生产环境的auto-flush时机随机触发了对未完整初始化A的处理。
Hibernate auto-flush机制触发时机：默认情况下，Hibernate在执行查询时会自动flush持久化上下文中的所有实体。此时A已经被实例化（虽然还没调用save），如果A的状态不符合持久化要求，就会抛出异常。
生产环境会话复用/并发问题：生产环境可能存在会话复用的情况，导致之前的会话残留了未清理的实体状态，随机触发异常。

解决方案

1. 确保实体A的所有必填属性都已初始化

检查实体A的映射和数据库表结构，确认所有非空属性都已设置值，哪怕是默认值。比如：

A a = new A();
a.setXX("xx");
a.setYY("default-value"); // 补充设置所有非空属性

2. 调整事务内的代码顺序，避免查询前触发A的flush

把aRepository.save(a)移到查询B之后，这样查询时A还没被加入到持久化上下文，不会触发flush处理A：

@Transactional
public void saveData(){
    // 先查询B，此时持久化上下文没有A的实例，不会触发相关flush
    B b = bRepository.findFirstByImei("xxx");
    // 处理B的逻辑
    A a = new A();
    a.setXX("xx");
    // 确保所有必填属性设置完成后再保存
    aRepository.save(a);
}

3. 控制查询的flush模式，关闭auto-flush

如果必须在查询前创建A，可以修改查询的flush模式，让查询不触发auto-flush。可以通过@QueryHint实现：

// 在Repository接口的方法上添加注解
@QueryHints(value = @QueryHint(name = org.hibernate.annotations.QueryHints.FLUSH_MODE, value = "COMMIT"))
B findFirstByImei(String imei);

或者在调用查询时指定flush模式：

B b = bRepository.findFirstByImei("xxx", 
    JpaRepository.QueryHints.HINT_FLUSH_MODE, FlushModeType.COMMIT);

4. 检查Hibernate版本，升级修复已知bug

如果使用的Hibernate版本较旧，可能存在auto-flush场景下的NPE bug，建议升级到5.4.x或更高的稳定版本（比如5.4.32.Final），这类版本修复了不少flush相关的问题。

补充：异常信息原文

java.lang.NullPointerException: null
at org.hibernate.event.internal.AbstractFlushingEventListener.prepareEntityFlushes(AbstractFlushingEventListener.java:145)
at org.hibernate.event.internal.AbstractFlushingEventListener.flushEverythingToExecutions(AbstractFlushingEventListener.java:81)
at org.hibernate.event.internal.DefaultAutoFlushEventListener.onAutoFlush(DefaultAutoFlushEventListener.java:50)
at org.hibernate.event.service.internal.EventListenerGroupImpl.fireEventOnEachListener(EventListenerGroupImpl.java:102)
at org.hibernate.internal.SessionImpl.autoFlushIfRequired(SessionImpl.java:1327)
at org.hibernate.internal.SessionImpl.list(SessionImpl.java:1407)
at org.hibernate.query.internal.AbstractProducedQuery.doList(AbstractProducedQuery.java:1625)
at org.hibernate.query.internal.AbstractProducedQuery.list(AbstractProducedQuery.java:1593)
at org.hibernate.query.internal.AbstractProducedQuery.getSingleResult(AbstractProducedQuery.java:1641)
at org.hibernate.query.criteria.internal.compile.CriteriaQueryTypeQueryAdapter.getSingleResult(CriteriaQueryTypeQueryAdapter.java:111)
at org.springframework.data.jpa.repository.query.JpaQueryExecution$SingleEntityExecution.doExecute(JpaQueryExecution.java:196)
at org.springframework.data.jpa.repository.query.JpaQueryExecution.execute(JpaQueryExecution.java:88)
at org.springframework.data.jpa.repository.query.AbstractJpaQuery.doExecute(AbstractJpaQuery.java:155)
at org.springframework.data.jpa.repository.query.AbstractJpaQuery.execute(AbstractJpaQuery.java:143)
at org.springframework.data.repository.core.support.RepositoryMethodInvoker.doInvoke(RepositoryMethodInvoker.java:137)
at org.springframework.data.repository.core.support.RepositoryMethodInvoker.invoke(RepositoryMethodInvoker.java:121)
at org.springframework.data.repository.core.support.QueryExecutorMethodInterceptor.doInvoke(QueryExecutorMethodInterceptor.java:152)
at org.springframework.data.repository.core.support.QueryExecutorMethodInterceptor.invoke(QueryExecutorMethodInterceptor.java:131)
at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:186)
at org.springframework.data.projection.DefaultMethodInvokingMethodInterceptor.invoke(DefaultMethodInvokingMethodInterceptor.java:80)
at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:186)
at org.springframework.transaction.interceptor.TransactionInterceptor$1.proceedWithInvocation(TransactionInterceptor.java:123)
at org.springframework.transaction.interceptor.TransactionAspectSupport.invokeWithinTransaction(TransactionAspectSupport.java:388)
at org.springframework.transaction.interceptor.TransactionInterceptor.invoke(TransactionInterceptor.java:119)
at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:186)
at org.springframework.dao.support.PersistenceExceptionTranslationInterceptor.invoke(PersistenceExceptionTranslationInterceptor.java:137)
at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:186)
at org.springframework.data.jpa.repository.support.CrudMethodMetadataPostProcessor$CrudMethodMetadataPopulatingMethodInterceptor.invoke(CrudMethodMetadataPostProcessor.java:145)
at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:186)
at org.springframework.aop.interceptor.ExposeInvocationInterceptor.invoke(ExposeInvocationInterceptor.java:97)
at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:186)
at datadog.trace.instrumentation.springdata.RepositoryInterceptor.invoke(RepositoryInterceptor.java:41)
at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:186)
at org.springframework.aop.framework.JdkDynamicAopProxy.invoke(JdkDynamicAopProxy.java:215)
at com.sun.proxy.$Proxy251.findFirstByImei(Unknown Source)

内容的提问来源于stack exchange，提问作者Min Yang

使用JPA结合Hibernate查询数据时随机出现NullPointerException问题求助

问题场景回顾 #

可能的原因 #

解决方案 #