GlassFish4.1+JSF2+JPA2应用按钮触发EJB bean时EntityManagerFactory获取异常

看起来你遇到的是个典型的容器管理EntityManager在长生命周期Bean中的上下文冲突——@PostConstruct阶段能正常调用EntityManager，但用户触发按钮调用Bean方法时就抛出java.lang.IllegalStateException: Unable to retrieve EntityManagerFactory for unitName null，其他调用正常，这说明问题出在EntityManager的生命周期绑定和事务上下文上，下面给你一步步排查和解决的方案：

1. 先确认持久化单元的注入配置 #

首先检查你的@ApplicationScoped EJB中EntityManager的注入代码，确保@PersistenceContext指定了正确的unitName——这是最容易忽略的点：

// 错误示例：未指定unitName，容器可能在非初始化阶段无法识别默认单元
// @PersistenceContext
// private EntityManager entityManager;

// 正确示例：明确指定persistence.xml中定义的持久化单元名称
@PersistenceContext(unitName = "YourAppPersistenceUnit")
private EntityManager entityManager;

为什么@PostConstruct里能正常工作？因为Bean初始化阶段，容器会优先加载默认的持久化单元上下文，但后续请求阶段，容器的上下文切换后，没有明确unitName就会找不到对应的EntityManagerFactory，导致unitName null的错误。

2. 解决长生命周期Bean的EntityManager上下文问题 #

@ApplicationScoped是全局单例Bean，生命周期和应用一致，但容器管理的EntityManager（@PersistenceContext注入的）是和请求/事务绑定的——当没有活动事务时，调用EntityManager的方法会因为无法获取有效上下文而失败。而@PostConstruct阶段容器处于初始化事务环境中，所以能正常调用。

针对这个问题，有两种常用解决方案：

方案A：给按钮触发的方法添加事务注解 #

在EJB的方法上添加@TransactionAttribute注解，强制开启事务上下文，确保EntityManager能正常获取：

import javax.ejb.TransactionAttribute;
import javax.ejb.TransactionAttributeType;

@ApplicationScoped
public class YourEJBBean {

    @PersistenceContext(unitName = "YourAppPersistenceUnit")
    private EntityManager entityManager;

    @PostConstruct
    public void init() {
        // 这里能正常调用，因为初始化阶段有容器事务上下文
        entityManager.createQuery("...").getResultList();
    }

    // 给按钮触发的方法添加事务注解
    @TransactionAttribute(TransactionAttributeType.REQUIRED)
    public void handleButtonClick() {
        // 现在有了事务上下文，EntityManager能正常工作
        entityManager.persist(yourEntity);
    }
}

方案B：改用应用管理的EntityManager #

如果你的方法不需要容器管理事务，或者希望完全控制EntityManager的生命周期，可以改用@PersistenceUnit注入EntityManagerFactory，手动创建和关闭EntityManager：

import javax.persistence.PersistenceUnit;
import javax.persistence.EntityManagerFactory;
import javax.persistence.EntityManager;

@ApplicationScoped
public class YourEJBBean {

    @PersistenceUnit(unitName = "YourAppPersistenceUnit")
    private EntityManagerFactory emf;

    @PostConstruct
    public void init() {
        // 初始化阶段也可以用这种方式
        try (EntityManager em = emf.createEntityManager()) {
            em.createQuery("...").getResultList();
        }
    }

    public void handleButtonClick() {
        // 手动创建EntityManager，用完关闭（用try-with-resources自动关闭）
        try (EntityManager em = emf.createEntityManager()) {
            em.getTransaction().begin();
            em.persist(yourEntity);
            em.getTransaction().commit();
        } catch (Exception e) {
            // 处理事务异常
        }
    }
}

这种方式适合在长生命周期Bean中使用，因为你完全控制EntityManager的创建和销毁，不会受容器上下文的影响。

3. 验证GlassFish的持久化单元部署 #

最后，检查GlassFish的服务器日志，确认启动时没有持久化单元的加载错误——如果persistence.xml配置有误（比如类路径找不到实体类、数据源配置错误），容器可能在初始化阶段能临时加载，但后续请求时会失败。你可以在GlassFish的管理控制台（默认http://localhost:4848）的Applications下查看你的应用的持久化单元状态，确保它已成功部署。

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