<think>
我们面对的问题是
Spring Boot应用启动时出现`
java.lang.NoClassDefFoundError
: org/apache/commons/
lang/StringUtils`错误。这个错误表示在运行时找不到`
org.apache
.commons
.lang.StringUtils`类。虽然错误信息中提到的类属于Apache Commons
Lang库，但值得注意的是，Commons
Lang有两个主要版本：2
.x和3
.x，它们的包名有所不同。
引用[1]中提到了一个编译时使用类路径的例子，但我们要解决的是运行时问题。在
Spring Boot中，这类错误通常由以下原因引起：
1
. 项目缺少Apache Commons
Lang依赖
2
. 项目依赖了Commons
Lang 3
.x，但代码中引用的却是Commons
Lang 2
.x的类（因为3
.x的包名改为`
org.apache
.commons
.lang3`）
3
. 依赖冲突导致Commons
Lang库未被正确引入
### 解决方案
#### 1
. **确认并添加正确的依赖**
- **Commons
Lang 2
.x**：包名为`
org.apache
.commons
.lang`，包含`StringUtils`类。
- **Commons
Lang 3
.x**：包名为`
org.apache
.commons
.lang3`，同样包含`StringUtils`类，但包名不同。
如果代码中使用的包名是`
org.apache
.commons
.lang`（没有3），则需要添加Commons
Lang 2
.x依赖：
```xml
<dependency>
<groupId>commons
-lang</groupId>
<artifactId>commons
-lang</artifactId>
<version>2
.6</version> <!
-- 或最新2
.x版本
-->
</dependency>
```
如果使用的是`
org.apache
.commons
.lang3`，则添加3
.x依赖：
```xml
<dependency>
<groupId>
org.apache
.commons</groupId>
<artifactId>commons
-lang3</artifactId>
<version>3
.12
.0</version> <!
-- 或更高版本
-->
</dependency>
```
**注意**：
Spring Boot的某些 starter 可能已经间接引入了 Commons
Lang 3
.x，因此需要检查实际代码中使用的包路径。
#### 2
. **检查代码中的包导入**
在代码中检查所有导入`StringUtils`的语句，确保包名正确：
- 使用2
.x：`import
org.apache
.commons
.lang.StringUtils;`
- 使用3
.x：`import
org.apache
.commons
.lang3
.StringUtils;`
如果代码中导入的是2
.x的包，但项目中只有3
.x的库，则会出现`NoClassDefFoundError`。此时有两种选择：
- 修改代码，使用3
.x的包名（推荐，因为2
.x已停止更新）
- 添加2
.x依赖（如果无法修改代码）
#### 3
. **排除依赖冲突**
如果已经添加了依赖但仍然报错，可能是由于依赖冲突导致Commons
Lang库未被正确加载。使用Maven或Gradle检查依赖树：
**Maven**：
```bash
mvn dependency
:tree
```
查找是否有多个版本的Commons
Lang，或者是否有其他库排除了Commons
Lang。
例如，若发现某个依赖排除了Commons
Lang，可以尝试在项目中显式添加所需版本，或者排除该排除行为（如果可能）。
**Gradle**：
```bash
gradle dependencies
```
如果存在版本冲突，可以在`build
.gradle`中强制指定版本：
```groovy
configurations
.all {
resolutionStrategy {
force 'commons
-lang:commons
-lang:2
.6'
// 或者 force '
org.apache
.commons
:commons
-lang3
:3
.12
.0'
}
}
```
#### 4
. **清理并重新构建项目**
在修改依赖后，执行清理操作并重新构建项目：
- Maven
: `mvn clean install`
- Gradle
: `gradle clean build`
然后重新启动
Spring Boot应用。
### 附加说明
- **
Spring Boot管理依赖版本**：如果项目继承了`
spring-boot-starter
-parent`，则默认管理的Commons
Lang3版本可能较低。可以在`pom
.xml`中覆盖版本：
```xml
<properties>
<commons
-lang3
.version>3
.12
.0</commons
-lang3
.version>
</properties>
```
- **检查打包后的JAR**：确保最终生成的JAR（或WAR）文件中的`
BOOT-INF/lib`目录下包含正确的Commons
Lang JAR。可以使用以下命令检查：
```bash
jar tf target/your
-application
.jar | grep 'commons
-lang'
```
### 验证
编写一个简单的测试类，在应用启动后检查`StringUtils`类是否存在：
```
java
import
org.apache
.commons
.lang3
.StringUtils; // 或
org.apache
.commons
.lang.StringUtils
public class TestStringUtils {
public static void main(String[] args) {
if (StringUtils
.isEmpty("")) {
System
.out
.println("StringUtils is available!");
}
}
}
```
通过以上步骤，应该能解决`NoClassDefFoundError
: org/apache/commons/
lang/StringUtils`错误。如果问题仍然存在，请检查运行时环境（如服务器类路径）是否有干扰。
§§相关问题§§
1
. 如何在
Spring Boot 应用中有效地管理第三方库的版本冲突？
2
. 除了 Apache Commons
Lang，还有哪些常用的
Java 工具库？
3
. 如何避免在
Java 项目中因包名变化引起的 ClassNotFoundException 或 NoClassDefFoundError？
</think>
### 解决
Spring Boot 启动报错：`
java.lang.NoClassDefFoundError
: org/apache/commons/
lang/StringUtils`
此错误表明
Spring Boot 应用在运行时缺失 Apache Commons
Lang 的 `StringUtils` 类。根本原因通常是**依赖缺失、版本冲突或包名变化**。以下是系统化的解决方案：
---
### 1
. **添加正确版本的 Apache Commons
Lang 依赖**
#### 关键区分：
- **Commons
Lang 2
.x**：包名为 `
org.apache
.commons
.lang`（含 `StringUtils`）
- **Commons
Lang 3
.x**：包名为 `
org.apache
.commons
.lang3`（`StringUtils` 在 `
lang3` 下）
根据代码中实际导入的包名添加依赖：
```xml
<!
-- 如果是 2
.x 版本（旧项目常见）
-->
<dependency>
<groupId>commons
-lang</groupId>
<artifactId>commons
-lang</artifactId>
<version>2
.6</version>
</dependency>
<!
-- 如果是 3
.x 版本（推荐）
-->
<dependency>
<groupId>
org.apache
.commons</groupId>
<artifactId>commons
-lang3</artifactId>
<version>3
.12
.0</version>
</dependency>
```
> **验证**：执行 `mvn dependency
:tree | grep 'commons
-lang'` 确认依赖已加载。
---
### 2
. **修正代码中的包导入**
检查所有使用 `StringUtils` 的
Java 文件：
```
java
// 错误导入（旧版 2
.x 包名）
import
org.apache
.commons
.lang.StringUtils;
// 正确导入（新版 3
.x 包名）
import
org.apache
.commons
.lang3
.StringUtils;
```
若无法修改源码（如第三方库依赖旧版），需强制添加 `commons
-lang:2
.6` 依赖。
---
### 3
. **解决依赖冲突**
若已存在 Commons
Lang 但依然报错，可能是版本冲突：
```bash
# Maven 依赖树分析
mvn dependency
:tree
-Dincludes=commons
-lang*
# Gradle 依赖树分析
gradle dependencies | grep 'commons
-lang'
```
在 `pom
.xml` 中排除冲突版本：
```xml
<dependency>
<groupId>com
.conflicting
.library</groupId>
<artifactId>some
-artifact</artifactId>
<exclusions>
<exclusion>
<groupId>commons
-lang</groupId>
<artifactId>commons
-lang</artifactId>
</exclusion>
</exclusions>
</dependency>
```
---
### 4
. **检查
Spring Boot 的依赖管理**
若继承 `
spring-boot-starter
-parent`，默认管理的 `commons
-lang3` 版本可能过低：
```xml
<!
-- 在 pom
.xml 中覆盖版本
-->
<properties>
<commons
-lang3
.version>3
.12
.0</commons
-lang3
.version>
</properties>
```
---
### 5
. **验证打包结果**
检查最终 JAR 文件是否包含 Commons
Lang：
```bash
jar tf target/your
-app
.jar | grep 'commons
-lang'
```
若缺失，检查 Maven 插件配置：
```xml
<build>
<plugins>
<plugin>
<groupId>
org.springframework
.boot</groupId>
<artifactId>
spring-boot-maven
-plugin</artifactId>
<configuration>
<includes>
<include>
<groupId>
org.apache
.commons</groupId>
<artifactId>commons
-lang3</artifactId>
</include>
</includes>
</configuration>
</plugin>
</plugins>
</build>
```
---
### 验证修复
添加测试代码验证类可用性：
```
java
public class ValidateStringUtils {
public static void main(String[] args) {
try {
Class
.forName("
org.apache
.commons
.lang3
.StringUtils");
System
.out
.println("StringUtils loaded successfully!");
} catch (ClassNotFoundException e) {
e
.printStackTrace();
}
}
}
```
---
### 常见陷阱排查
1
. **作用域错误**：确保依赖不是 `provided`（除非服务器已自带）
2
. **缓存问题**：清理构建缓存后重启
```bash
mvn clean install &&
java -jar target/your
-app
.jar
```
3
. **多模块项目**：在启动模块显式添加依赖
通过以上步骤，95% 的 `NoClassDefFoundError
: StringUtils` 错误可被解决。若问题仍存，需检查是否有自定义类加载器干扰加载过程[^1]。
最低0.47元/天 解锁文章
扫一扫
738
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
