J2EE环境下Hibernate 5.1实体引导与持久化上下文创建问题咨询

看起来你遇到的核心问题出在持久化单元配置缺失和EntityManager获取方式不规范上，结合J2EE + Hibernate 5.1的环境，我给你一步步梳理解决方案：

1. 先修复persistence.xml的实体映射配置 #

你的persistence.xml没有配置映射类，这会导致Hibernate无法识别PersonEntity，自然无法创建有效的持久化上下文。有两种配置方式：

方式一：显式列出实体类 #

在你的持久化单元中添加<class>标签指定实体类全路径：

<persistence xmlns="http://xmlns.jcp.org/xml/ns/persistence"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence
             http://xmlns.jcp.org/xml/ns/persistence/persistence_2_2.xsd"
             version="2.2">
             
    <persistence-unit name="PersonPU" transaction-type="JTA">
        <!-- 配置你的JTA数据源，根据J2EE容器调整JNDI名称 -->
        <jta-data-source>java:/comp/env/jdbc/YourDB</jta-data-source>
        
        <!-- 显式声明实体类 -->
        <class>com.yourpackage.PersonEntity</class>
        
        <properties>
            <!-- Hibernate核心配置 -->
            <property name="hibernate.dialect" value="org.hibernate.dialect.MySQL5Dialect"/>
            <property name="hibernate.show_sql" value="true"/>
            <property name="hibernate.format_sql" value="true"/>
        </properties>
    </persistence-unit>
</persistence>

方式二：自动扫描类路径下的实体 #

如果你的实体类都带@Entity注解，可以添加<exclude-unlisted-classes>false</exclude-unlisted-classes>让容器自动扫描：

<persistence-unit name="PersonPU" transaction-type="JTA">
    <!-- 数据源配置 -->
    <jta-data-source>java:/comp/env/jdbc/YourDB</jta-data-source>
    
    <!-- 允许容器自动扫描类路径下的@Entity类 -->
    <exclude-unlisted-classes>false</exclude-unlisted-classes>
    
    <!-- Hibernate配置... -->
</persistence-unit>

2. J2EE环境中正确创建/获取持久化上下文（EntityManager） #

在J2EE里，我们要遵循容器管理的规范，避免手动管理资源时出现线程安全问题：

错误：单例PersonDao的风险 #

EntityManager是非线程安全的，绝对不能在单例类中持有一个EntityManager实例。正确的做法是用容器管理的Bean（比如EJB）或者每次请求创建新的EntityManager。

推荐方案1：用EJB Stateless Bean实现Dao（J2EE规范方式） #

将PersonDao改成无状态会话Bean，容器会自动注入线程安全的EntityManager代理：

import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import javax.ejb.Stateless;

@Stateless
public class PersonDao {

    // 容器注入EntityManager，代理自动处理线程安全
    @PersistenceContext(unitName = "PersonPU")
    private EntityManager em;

    public PersonEntity findPersonById(Long id) {
        return em.find(PersonEntity.class, id);
    }

    // 其他CRUD方法...
}

然后在LoginServlet中注入这个Dao：

import javax.ejb.EJB;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebServlet("/login")
public class LoginServlet extends HttpServlet {

    @EJB
    private PersonDao personDao;

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 直接使用Dao，EntityManager由容器管理
        PersonEntity person = personDao.findPersonById(1L);
        // 处理登录逻辑...
    }
}

推荐方案2：Servlet中手动管理EntityManagerFactory #

如果不想用EJB，就在Servlet的init()方法中初始化全局的EntityManagerFactory（只初始化一次），每次请求创建新的EntityManager：

import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.Persistence;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebServlet("/login")
public class LoginServlet extends HttpServlet {

    private EntityManagerFactory emf;

    @Override
    public void init() throws ServletException {
        super.init();
        // 初始化EntityManagerFactory，全局唯一
        emf = Persistence.createEntityManagerFactory("PersonPU");
    }

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        EntityManager em = null;
        try {
            em = emf.createEntityManager();
            // 执行数据库操作
            PersonEntity person = em.find(PersonEntity.class, 1L);
            // 处理登录逻辑...
        } finally {
            // 必须关闭EntityManager
            if (em != null && em.isOpen()) {
                em.close();
            }
        }
    }

    @Override
    public void destroy() {
        // 销毁时关闭EntityManagerFactory
        if (emf != null && emf.isOpen()) {
            emf.close();
        }
        super.destroy();
    }
}

3. J2EE引导Hibernate实体的流程 #

J2EE容器启动时会做这些事情：

1. 读取persistence.xml中的持久化单元配置；
2. 根据配置扫描实体类（显式配置或自动扫描），Hibernate解析实体类的@Entity、@Id等注解生成映射元数据；
3. 创建EntityManagerFactory（全局单例）；
4. 当你通过容器注入或手动创建EntityManager时，Hibernate会基于EntityManagerFactory创建持久化上下文，用于管理实体的生命周期。

关键注意事项 #

• 持久化单元名称必须一致：@PersistenceContext或Persistence.createEntityManagerFactory中的unitName必须和persistence.xml里的name完全匹配；
• 数据源配置正确：确保J2EE容器中已经配置好对应的数据源，persistence.xml的jta-data-source指向正确的JNDI名称；
• EntityManager线程安全：永远不要在多线程环境（比如单例、全局变量）中持有EntityManager实例。

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