JPA EntityManager更新后返回旧状态问题求助

引言 #

正在将GWT-RPC应用迁移为RESTful服务，用domino-rest替换所有RPC调用，同时把jersey1升级到jersey2（此前jersey1已用于部分外部通信）。迁移后初期以为一切正常。

依赖注入使用Guice 6，迁移到Jersey2后采用HK2-Guice-bridge。多数据库持久化采用JPA/Hibernate。迁移到Jersey2和domino-rest之前，所有功能均正常运行。

问题 #

领域对象更新到数据库的操作完全正常，但通过GET请求再次获取该对象时，有时返回更新前的旧版本，有时返回正确的更新后版本。已确认不是GET缓存问题，问题根源是Repository中的EntityManager有时会返回旧版本。

Jersey2日志显示请求使用了不同线程，而EntityManager并非线程安全，怀疑这是问题核心，但不确定是否存在其他诱因。需要排查线程安全相关问题的思路。

代码示例 #

通用仓库类 #

public class Repository<T> {

    @Inject
    private Provider<EntityManager> emProvider;

    private final Class<T> entityType;

    @Inject
    public Repository(final Class<T> entityType) {
        this.entityType = entityType;
    }

    public EntityManager getEntityManager() {
        return emProvider.get();
    }

    public T get(long id) {
        return getEntityManager().find(entityType, id);
    }

    public T update(T o) {
        EntityManager em = getEntityManager();
        em.merge(o);
        em.flush();
        return o;
    }

    //other code omitted
}

持久化模块（多个模块之一） #

public class PersistenceModule extends PrivateModule {

    private final String unitName;

    public PersistenceModule(String unitName) {
        this.unitName = unitName;
    }

    @Override
    protected void configure() {
        // I know setAutoBeginWorkOnEntityManagerCreation is not recommended, but for the time being.
        install(new JpaPersistModule(unitName, JpaPersistOptions.builder().setAutoBeginWorkOnEntityManagerCreation(true).build()));
        bind(PersistenceManager.class).asEagerSingleton();
        expose(PersistenceManager.class);

        // User
        TypeLiteral<Repository<User>> userRepoType = new TypeLiteral<>() {
        };
        bind(userRepoType).toInstance(new Repository<>(User.class));
        expose(userRepoType);
    }
}

持久化管理器（多个管理器之一） #

@Singleton
public class PersistenceManager {

    private final PersistService service;

    @Inject
    public PersistenceManager(PersistService service) {
        this.service = service;
        service.start();
    }

    public void stop() {
        service.stop();
    }
}

补充说明 #

Web应用的入口是继承ResourceConfig的ApplicationConfig，在此类中调用Guice.createInjector并传入上述PersistenceModule，随后将注入器传递给HK2-Guice Bridge。

排查思路 #

1. 验证EntityManager的作用域

   • 检查Guice的JpaPersistModule是否为每个请求（或每个线程）提供独立的EntityManager实例。默认情况下，Guice的JPA扩展应该将EntityManager绑定为请求作用域，但如果HK2-Guice桥接配置不当，可能导致作用域失效，出现多线程共享同一实例的情况。
   • 可在Repository.getEntityManager()方法中添加日志，打印EntityManager的哈希值，确认不同请求/线程是否复用了实例。

2. 检查事务边界

   • 当前update方法仅调用merge和flush，无显式事务提交。虽然开启了setAutoBeginWorkOnEntityManagerCreation自动事务，但Jersey2的请求线程模型可能导致事务未在请求结束时正确提交/回滚。
   • 建议为update和get方法添加显式事务管理，比如使用Guice的@Transactional注解（需确保事务拦截器已正确配置）。

3. EntityManager一级缓存问题

   • 若同一EntityManager实例被复用，其一级缓存（持久化上下文）会保留之前加载的实体，即便数据库数据已更新，后续find操作会直接返回缓存旧数据。
   • 可在get方法中调用EntityManager.refresh(entity)强制从数据库刷新数据，但这只是临时方案，根本解决方法是确保每个请求使用独立的EntityManager。

4. HK2-Guice桥接的作用域映射

   • HK2与Guice的作用域模型不完全一致，需确保桥接器正确映射请求作用域，比如HK2的RequestScoped和Guice的RequestScoped是否关联正确，避免EntityManager被错误绑定为单例或非请求作用域。
   • 检查ApplicationConfig中HK2-Guice桥接的配置代码，确认无作用域绑定遗漏。

5. 多数据库模块的隔离性

   • 因使用多个PersistenceModule，需确认每个模块的EntityManager是否被正确隔离，避免不同数据库的EntityManager混用导致数据读取错误。

内容的提问来源于stack exchange，提问作者Kai Krupka