Spring中用EntityManager监听Inventory变更存Log时EntityManager为空的解决

问题根源 #

你的MasterInventoryListener出现EntityManager为空，大概率是两个原因：

1. 监听器被JPA容器提前实例化（而非Spring容器），导致Spring的依赖注入（@Autowired）失效；
2. 监听JPA生命周期事件时，事务上下文尚未绑定，直接注入的EntityManager未被初始化。

结合SessionContextHolder和ApplicationReadyEvent的方案可以完美解决这两个问题，具体实现如下：

方案步骤 #

1. 用ApplicationReadyEvent延迟注册监听器

避免Spring过早实例化监听器，等容器完全启动、EntityManagerFactory就绪后再手动注册：

@Configuration
public class InventoryListenerConfig implements ApplicationListener<ApplicationReadyEvent> {

    @Autowired
    private EntityManagerFactory entityManagerFactory;

    @Override
    public void onApplicationEvent(ApplicationReadyEvent event) {
        // 容器完全初始化后注册监听器
        try (EntityManager em = entityManagerFactory.createEntityManager()) {
            em.getEventManager().registerListener(new MasterInventoryListener());
        }
    }
}

注：这里用try-with-resources确保EntityManager用完关闭，不占用资源。

2. 在监听器中通过SessionContextHolder获取EntityManager

不要在监听器类中直接注入EntityManager，而是在事件处理方法里从当前事务上下文获取：

public class MasterInventoryListener {

    @PostUpdate
    public void handleInventoryUpdate(Inventory inventory) {
        // 从当前会话上下文获取绑定的EntityManager
        EntityManager em = SessionContextHolder.getEntityManager();
        
        if (em != null) {
            InventoryAuditLog auditLog = new InventoryAuditLog();
            auditLog.setInventoryId(inventory.getId());
            auditLog.setChangeType("UPDATE");
            auditLog.setChangeTime(LocalDateTime.now());
            auditLog.setChangedFields(/* 这里可以封装变更字段 */);
            
            // 直接持久化，当前事务会自动提交
            em.persist(auditLog);
        }
    }

    // 同理实现@PostPersist、@PostDelete等方法
}

3. 确保SessionContextHolder配置正确

如果你的项目中没有现成的SessionContextHolder，可以自己实现一个简单的线程安全上下文：

public class SessionContextHolder {
    private static final ThreadLocal<EntityManager> ENTITY_MANAGER_HOLDER = new ThreadLocal<>();

    public static void setEntityManager(EntityManager em) {
        ENTITY_MANAGER_HOLDER.set(em);
    }

    public static EntityManager getEntityManager() {
        return ENTITY_MANAGER_HOLDER.get();
    }

    public static void clear() {
        ENTITY_MANAGER_HOLDER.remove();
    }
}

可以结合Spring的TransactionSynchronizationManager来自动绑定，比如在事务开始时设置EntityManager，结束时清除。

关键原理 #

• ApplicationReadyEvent：Spring在所有bean初始化完成、应用准备接收请求后触发该事件，此时EntityManagerFactory已经完全就绪，注册的监听器能获取到有效的EntityManager实例；
• SessionContextHolder：通过线程本地存储获取当前事务绑定的EntityManager，避免了JPA容器实例化监听器导致的Spring注入失效问题，同时保证在事务上下文内操作日志数据，无需额外手动管理事务。

内容的提问来源于stack exchange，提问作者harsh singh