Hibernate 5+Spring 6部署Tomcat10报错：无法构造当前会话上下文

• 本地Windows环境：可正常连接数据库、运行单元测试，但构建部署到Tomcat 10时抛出无法构造当前会话上下文错误
• 对比验证：项目在Linux平台升级至Java 21后，通过Jenkins（Maven 3.8.x）构建部署到Tomcat 10可正常运行
• 已做排查：尝试Stack Overflow多种方案，调整6年未修改的hibernate.xml配置无效，怀疑JAR兼容性问题

1. 对齐本地与Jenkins的Maven环境 #

• 确认本地Maven版本为3.8.x，与Jenkins环境一致，避免依赖解析差异
• 执行命令mvn clean install -U强制更新本地依赖仓库，清除过时或损坏的JAR包
• 对比本地构建产物target/WEB-INF/lib与Jenkins构建的lib目录，逐一核对Hibernate、JPA、Tomcat相关依赖的版本，找出差异项

2. 适配Tomcat 10的Jakarta EE规范 #

Tomcat 10基于Jakarta EE，替代了原Java EE API，旧版Hibernate可能存在API兼容问题：

• 检查hibernate.xml中的会话上下文配置：

  旧Java EE适配配置：<property name="hibernate.current_session_context_class">thread</property> 或 <property name="hibernate.current_session_context_class">org.hibernate.context.internal.ThreadLocalSessionContext</property>

• 若使用Hibernate 5.5+版本，需确保依赖的是hibernate-core-jakarta而非旧的hibernate-core，并尝试调整会话上下文配置为：

  <property name="hibernate.current_session_context_class">org.hibernate.context.internal.JTASessionContext</property>
  

3. 对齐本地与Linux的Java环境 #

• 确认本地Java版本为Java 21，且与Linux环境使用同一发行版（如均为OpenJDK），避免JDK差异导致的兼容性问题
• 检查JAVA_HOME、CATALINA_HOME环境变量配置，查看Tomcat启动日志确认使用的JVM版本是否为Java 21

4. 排查Tomcat本地类加载冲突 #

• 清空Tomcatwebapps目录下的旧项目文件，避免残留文件干扰
• 检查Tomcatlib目录是否存在Hibernate、JPA相关JAR，若有则移除，确保项目依赖由自身WAR包管理
• 查看Tomcat启动日志中的类加载记录，定位是否存在类找不到、版本冲突等异常信息

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