将Hibernate 4.3.5迁移至Tomcat 9.0.46 JavaEE项目时出现NoClassDefFoundError问题求助

这个问题我之前也碰到过，核心原因是运行时JVM找不到Hibernate的核心类org.hibernate.service.ServiceRegistry，本质是依赖配置错误或者部署时依赖没有被正确打包。咱们一步步来排查修复：

1. 修正pom.xml中的依赖问题 #

你的pom里有几个明显的错误，是导致类找不到的主要原因：

（1）修复hibernate-commons-annotations依赖 #

你给这个依赖加了<classifier>tests</classifier>，这会导致Maven只引入测试用的jar包，而不是主依赖，完全不符合需求。而且Hibernate 4.3.5对应的commons-annotations版本是4.3.0.Final（4.3.5版本不存在）。修改后的依赖应该是：

<dependency>
    <groupId>org.hibernate.common</groupId>
    <artifactId>hibernate-commons-annotations</artifactId>
    <version>4.3.0.Final</version>
</dependency>

（2）统一Hibernate版本号 #

你已经定义了hibernate.version属性，但有些依赖直接写死了版本号，容易导致版本不一致。把所有Hibernate相关依赖的版本统一用这个属性：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>${hibernate.version}</version>
</dependency>
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>${hibernate.version}</version>
</dependency>
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-entitymanager</artifactId>
    <version>${hibernate.version}</version>
</dependency>

（3）补充缺失的jboss-logging依赖 #

Hibernate 4.3依赖jboss-logging组件，没有它可能会出现更多类找不到的问题，建议添加：

<dependency>
    <groupId>org.jboss.logging</groupId>
    <artifactId>jboss-logging</artifactId>
    <version>3.3.0.Final</version>
</dependency>

2. 确保依赖被正确打包到Web应用 #

因为你的项目是war包格式，Maven默认会把非provided范围的依赖打包到WEB-INF/lib目录：

• 执行mvn clean package命令，生成war包后，解压打开WEB-INF/lib目录，检查是否包含hibernate-core-4.3.5.Final.jar、hibernate-commons-annotations-4.3.0.Final.jar等Hibernate相关jar包。
• 如果这些jar不在里面，检查pom中依赖的scope，除了javax.servlet-api是provided（Tomcat自带），其他Hibernate依赖都不要加scope，默认compile范围会被自动打包。

3. 检查IntelliJ的Tomcat部署配置 #

在IntelliJ中部署Tomcat时，确认：

• 打开Run/Debug Configurations -> 你的Tomcat实例 -> Deployment标签页，选中你的项目，查看右侧的"Libaries"，确保所有Hibernate相关的jar都在列表里。
• 不要手动把jar包放到Tomcat的全局lib目录，避免版本冲突，让Maven来管理依赖更可靠。

4. 验证Hibernate配置文件路径 #

虽然你说纯Java项目没问题，但Web项目中要确保hibernate.cfg.xml放在src/main/resources目录下，这样Maven会把它打包到WEB-INF/classes目录，Hibernate启动时才能正确加载配置。

完成以上步骤后，重新打包部署，应该就能解决这个NoClassDefFoundError问题了。

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