Exception in thread "main" java.lang.NoClassDefFoundError: javax/persistence/Cacheable 问题

本文解决了一个Hibernate操作中出现的NoClassDefFoundError错误,原因是缺少了javax.persistence.Cacheable类。通过引入hibernate-jpa-2.0-api-1.0.0.Final.jar库成功解决了问题。
我用annotations做hibernate操作时报这个错误请问是什么原因:
Exception in thread "main" java.lang.NoClassDefFoundError: javax/persistence/Cacheable
 at org.hibernate.cfg.AnnotationBinder.determineCacheSettings(AnnotationBinder.java:953)
 at org.hibernate.cfg.AnnotationBinder.bindClass(AnnotationBinder.java:596)
 at org.hibernate.cfg.AnnotationConfiguration.processArtifactsOfType(AnnotationConfiguration.java:636)
 at org.hibernate.cfg.AnnotationConfiguration.secondPassCompile(AnnotationConfiguration.java:359)
 at org.hibernate.cfg.Configuration.buildSessionFactory(Configuration.java:1377)
 at org.hibernate.cfg.AnnotationConfiguration.buildSessionFactory(AnnotationConfiguration.java:954)
 at TeacherTest.main(TeacherTest.java:17)
环境,hibernate3.5.5_annotations3.4.0
两个java类
TeacherTest
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.AnnotationConfiguration;
import org.hibernate.cfg.Configuration;
import com.bjsxt.hibernate.model.Teacher;
public class TeacherTest {
 public static void main(String[] args){
  Teacher t=new Teacher();
  t.setId(1);
  t.setName("t1");
  t.setTitle("教受");
  Configuration cfg=new AnnotationConfiguration();
  SessionFactory sf=cfg.configure().buildSessionFactory();
  Session session=sf.openSession();
  session.beginTransaction();
  session.save(t);
  session.getTransaction().commit();
  session.close();
  sf.close();
 }
}
Teacher
package com.bjsxt.hibernate.model;
import javax.persistence.Entity;
import javax.persistence.Id;
@Entity
public class Teacher {
 private int id;
 private String name;
 private String title;
 @Id
 public int getId() {
  return id;
 }
 public void setId(int id) {
  this.id = id;
 }

 public String getName() {
  return name;
 }

 public void setName(String name) {
  this.name = name;
 }

 public String getTitle() {
  return title;
 }

 public void setTitle(String title) {
  this.title = title;
 }
}
hibernate.cfg.xml中的mapping
<mapping class="com.bjsxt.hibernate.model.Teacher"/>


解决办法:
javax.persistence.Cacheable 是 JPA 2.0 规范中的东西!

需要加入hibernate-distribution-3.5.0-Final\lib\jpa目录下的hibernate-jpa-2.0-api-1.0.0.Final.jar
到path中
步骤:window->preferences-java->bulid path-userliberlay-hibernate-->add JARs->选择你的hibernate-jpa-2.0-api-1.0.0.Final.jar目录名,保存重新编译,问题解决

<think>我们正在解决的是`java.lang.ClassDefFoundError:javax/servlet/Servlet`错误。根据引用内容,该错误通常是因为缺少ServletAPI的依赖或者依赖的作用域配置不正确。引用[1]指出:该错误是常见问题,并提供解决思路。引用[2]和[3]则分别给出了具体的依赖配置示例。结合之前的回答,我们总结如下:解决方案步骤:1.**添加正确的ServletAPI依赖**:在Maven项目中,需要添加`javax.servlet:javax.servlet-api`依赖,并且作用域设置为`provided`(因为ServletAPI通常由应用服务器如Tomcat提供,在运行时不需要打包到WAR中)。例如,在`pom.xml`中添加:```xml<dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>4.0.1</version><!--请根据实际使用的服务器版本选择--><scope>provided</scope></dependency>```2.**检查其他依赖**:引用[2]中提到,当出现`ServletRequest`找不到时,引入了`spring-web`依赖。但注意,`spring-web`本身可能并不包含完整的ServletAPI,所以仍然需要上述ServletAPI依赖。引用[3]中则使用了`spring-boot-starter-tomcat`并设置`provided`作用域。在SpringBoot项目中,如果使用内嵌Tomcat,通常不需要单独添加ServletAPI,因为`spring-boot-starter-web`已经包含了。但是,如果你将应用打包为WAR并部署到外部Tomcat,则需要将内嵌容器依赖的作用域设置为`provided`,如:```xml<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-tomcat</artifactId><scope>provided</scope></dependency>```3.**作用域的重要性**:设置`provided`作用域是为了避免将ServletAPI打包到WAR中,因为应用服务器(如Tomcat)在运行时已经提供了这些类。如果打包进去,可能会引起类加载冲突。4.**清理和重建**:在添加依赖后,执行`mvncleaninstall`重新构建项目。5.**检查服务器运行时环境**:在IDE中,确保项目配置了正确的服务器运行时环境(如Tomcat),这样在开发和测试时,IDE会将服务器提供的库(包括ServletAPI)加入到类路径中。6.**排除冲突依赖**:使用`mvndependency:tree`检查是否有其他依赖引入了不同版本的ServletAPI,如果有,排除掉。根据用户的问题,他们遇到了`java.lang.ClassDefFoundError:javax/servlet/Servlet`,所以核心是确保在编译时和测试时有ServletAPI,而运行时由服务器提供。因此,我们推荐添加ServletAPI依赖并设置作用域为`provided`。注意:如果项目是SpringBoot项目,并且使用内嵌服务器(默认打包为可执行JAR),则不需要设置`provided`,因为内嵌服务器已经包含这些类。但如果是WAR包部署到外部服务器,则需要设置`provided`。如果用户的项目不是Maven项目,而是手动管理库,则需要下载`servlet-api.jar`并添加到编译类路径中,但不要放到运行时类路径(即部署时不要放到WEB-INF/lib下)。现在,我们按照要求生成回答。</think>### 解决 `java.lang.ClassDefFoundError: javax/servlet/Servlet` 错误 该错误表明 JVM 在运行时找不到 Servlet API 的核心类,根本原因是缺少必要的依赖或作用域配置错误。以下是系统化解决方案: #### 1. **添加 Servlet API 依赖(核心步骤)** - **Maven 项目**:在 `pom.xml` 中添加: ```xml <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>4.0.1</version> <!-- 根据服务器版本调整 --> <scope>provided</scope> <!-- 关键:避免打包冲突 --> </dependency> ``` ✅ 执行 `mvn clean install` 重新构建[^1][^2]。 - **Spring Boot 项目**:若使用内嵌 Tomcat: ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> <!-- 确保外部部署不打包 --> </dependency> ``` #### 2. **验证依赖作用域** - **错误配置**:若作用域为 `compile`(默认),会导致 Servlet API 被打包到 WAR 中,与服务器自带库冲突 - **正确做法**:始终使用 `provided`,确保: - 编译时:类可见 - 运行时:由应用服务器(如 Tomcat)提供实现[^1][^3] - 检查其他相关依赖(如 `spring-web`)是否覆盖了 Servlet API #### 3. **服务器环境检查** - 确认应用服务器(Tomcat/Jetty 等)的 `lib` 目录包含 `servlet-api.jar` - **Tomcat 路径示例**: - Tomcat 9:`$CATALINA_HOME/lib/servlet-api.jar` - 版本不匹配时更新 JAR 文件 #### 4. **IDE 配置修复** - **Eclipse**: 1. 右键项目 → Properties 2. Targeted Runtimes → 勾选对应的 Tomcat 版本 - **IntelliJ**: 1. File → Project Structure → Modules 2. Dependencies → 添加 Tomcat 的 `servlet-api.jar` #### 5. **解决依赖冲突** - 执行依赖树分析: ```bash mvn dependency:tree -Dincludes=javax.servlet ``` - 排除冲突依赖: ```xml <dependency> <groupId>problematic-group</groupId> <artifactId>problematic-artifact</artifactId> <exclusions> <exclusion> <groupId>javax.servlet</groupId> <artifactId>servlet-api</artifactId> </exclusion> </exclusions> </dependency> ``` #### 6. **清理重建项目** - 删除构建目录: - Maven:`rm -rf target/` - Gradle:`rm -rf build/` - 刷新 IDE 的构建缓存 - 重新打包部署 > **根本原因**:Servlet API 应由应用服务器提供,开发环境中需通过 `provided` 作用域声明依赖。此错误通常不会出现在生产环境[^1]。 --- ### 相关问题 1. 如何排查 Maven 依赖冲突导致的 `NoClassDefFoundError`? 2. Tomcat 服务器启动时如何加载 Servlet API? 3. 在 Spring Boot 中如何正确配置 WAR 包部署到外部 Tomcat? 4. `provided` 和 `compileOnly` 作用域在 Java Web 开发中有何区别? 5. 为什么不同版本的 Tomcat 需要不同的 Servlet API 版本?
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值