<th
ink>我们正在
解决的是`
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`找不到时，引入了`spr
ing-web`依赖。但注意，`spr
ing-web`本身可能并不包含完整的ServletAPI，所以仍然需要上述ServletAPI依赖。引用[3]中则使用了`spr
ing-boot-starter-tomcat`并设置`provided`作用域。在Spr
ingBoot项目中，如果使用内嵌Tomcat，通常不需要单独添加ServletAPI，因为`spr
ing-boot-starter-web`已经包含了。但是，如果你将应用打包为WAR并部署到外部Tomcat，则需要将内嵌容器依赖的作用域设置为`provided`，如：```xml<dependency><groupId>org
.spr
ingframework
.boot</groupId><artifactId>spr
ing-boot-starter-tomcat</artifactId><scope>provided</scope></dependency>```3
.**作用域的重要性**：设置`provided`作用域是为了避免将ServletAPI打包到WAR中，因为应用服务器（如Tomcat）在运行时已经提供了这些类。如果打包进去，可能会引起类加载冲突。4
.**清理和重建**：在添加依赖后，执行`mvnclean
install`重新构建项目。5
.**检查服务器运行时环境**：在IDE中，确保项目配置了正确的服务器运行时环境（如Tomcat），这样在开发和测试时，IDE会将服务器提供的库（包括ServletAPI）加入到类路径中。6
.**排除冲突依赖**：使用`mvndependency
:tree`检查是否有其他依赖引入了不同版本的ServletAPI，如果有，排除掉。根据用户的问题，他们遇到了`
java.lang.ClassDefFoundError
:javax/servlet/Servlet`，所以核心是确保在编译时和测试时有ServletAPI，而运行时由服务器提供。因此，我们推荐添加ServletAPI依赖并设置作用域为`provided`。注意：如果项目是Spr
ingBoot项目，并且使用内嵌服务器（默认打包为可执行JAR），则不需要设置`provided`，因为内嵌服务器已经包含这些类。但如果是WAR包部署到外部服务器，则需要设置`provided`。如果用户的项目不是Maven项目，而是手动管理库，则需要下载`servlet-api
.jar`并添加到编译类路径中，但不要放到运行时类路径（即部署时不要放到WEB-
INF/lib下）。现在，我们按照要求生成回答。</th
ink>###
解决 `
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]。
- **Spr
ing Boot 项目**：若使用内嵌 Tomcat：
```xml
<dependency>
<groupId>org
.spr
ingframework
.boot</groupId>
<artifactId>spr
ing-boot-starter-tomcat</artifactId>
<scope>provided</scope> <!-- 确保外部部署不打包 -->
</dependency>
```
#### 2
. **验证依赖作用域**
- **错误配置**：若作用域为 `compile`（默认），会导致 Servlet API 被打包到 WAR 中，与服务器自带库冲突
- **正确做法**：始终使用 `provided`，确保：
- 编译时：类可见
- 运行时：由应用服务器（如 Tomcat）提供实现[^1][^3]
- 检查其他相关依赖（如 `spr
ing-web`）是否覆盖了 Servlet API
#### 3
. **服务器环境检查**
- 确认应用服务器（Tomcat/Jetty 等）的 `lib` 目录包含 `servlet-api
.jar`
- **Tomcat 路径示例**：
- Tomcat 9：`$CATAL
INA_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 -D
includes=
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
. 在 Spr
ing Boot 中如何正确配置 WAR 包部署到外部 Tomcat？
4
. `provided` 和 `compileOnly` 作用域在
Java Web 开发中有何区别？
5
. 为什么不同版本的 Tomcat 需要不同的 Servlet API 版本？
本文介绍了在Java命令行环境下编译和运行位于特定包内的类文件时遇到的问题及解决方法。当试图直接运行包内的类时，会因默认在java.lang包内查找而失败。正确的做法是切换到包含该包的目录，并使用全限定类名来运行。
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
