<think>我们正在解决Maven项目在
IntelliJ IDEA中引入本地
jar包后，
运行时出现`nested exception is
java.lang.NoClassDefFoundError`的问题。这个
错误通常是因为项目在
运行时找不到对应的类，而
编译时可能正常（因为
编译时通过本地路径引入了
jar包）。我们需要确保
jar包在
编译和运行时都被正确
包含。
解决方案通常有以下几种：
1
. **使用Maven的本地依赖（system scope）**：将本地
jar包通过`system`作用域引入，并指定`systemPath`。但需要注意，这种方式在打
包时通常不会
包含这个
jar包，所以可能会导致
运行时缺失。因此，需要额外配置确保打
包时
包含该
jar。
2
. **将
jar包安装到本地Maven仓库**：使用`mvn install:install
-file`命令将
jar包安装到本地仓库，然后在pom
.xml中像其他依赖一样引用。这样，Maven在构建时会从本地仓库获取该
jar包，并且打
包时也会
包含。
3
. **配置打
包插件（如maven
-assembly
-plugin或maven
-shade
-plugin）**：如果使用`system`作用域，需要配置打
包插件将依赖的
jar包包含进最终构建产物中。
由于
错误信息中提到了`
NoClassDefFoundError`，并且是
运行时
错误，我们更倾向于使用第二种方法（安装到本地仓库）或者在使用第一种方法时确保打
包正确。
下面详细介绍两种常用方法：
### 方法1：将
jar包安装到本地Maven仓库
步骤：
1
. 打开终端（或
IDEA的Terminal），执行以下命令：
```bash
mvn install:install
-file
-Dfile=
jar包的路径
-DgroupId=自定义的groupId
-DartifactId=自定义的artifactId
-Dversion=版本号
-Dpackaging=
jar
```
例如，假设
jar包名为`example
.jar`，位于项目根目录下的`lib`文件夹中，我们可以这样：
```bash
mvn install:install
-file
-Dfile=
./lib/example
.jar -DgroupId=com
.example
-DartifactId=example
-Dversion=1
.0
-Dpackaging=
jar
```
2
. 在项目的`pom
.xml`中添加依赖：
```xml
<dependency>
<groupId>com
.example</groupId>
<artifactId>example</artifactId>
<version>1
.0</version>
</dependency>
```
3
. 重新构建项目（执行Maven的clean
和install）。
### 方法2：使用system作用域并配置打
包插件
如果不想将
jar包安装到本地仓库（例如，这个
jar包只是临时使用，或者不能安装到公共仓库），可以使用`system`作用域，但需要配置打
包插件。
1
. 在`pom
.xml`中声明依赖（假设
jar包放在项目根目录下的`lib`文件夹中）：
```xml
<dependency>
<groupId>com
.example</groupId>
<artifactId>example</artifactId>
<version>1
.0</version>
<scope>system</scope>
<systemPath>${project
.basedir}/lib/example
.jar</systemPath>
</dependency>
```
2
. 配置`maven
-assembly
-plugin`或`maven
-shade
-plugin`，确保打
包时
包含该
jar包。这里以`maven
-assembly
-plugin`为例：
```xml
<build>
<plugins>
<plugin>
<artifactId>maven
-assembly
-plugin</artifactId>
<version>3
.3
.0</version>
<configuration>
<descriptorRefs>
<descriptorRef>
jar-with
-dependencies</descriptorRef>
</descriptorRefs>
</configuration>
<executions>
<execution>
<id>make
-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
```
这样，执行`mvn package`时，会
生成一个
包含所有依赖的
jar包（
包括`system`作用域的
jar包）。
3
. 运行打
包后的
jar文件（通常位于`target`目录，以`
-jar-with
-dependencies
.jar`结尾）。
### 在
IntelliJ IDEA中的额外检查
在
IDEA中，还需要确保：
- 如果使用方法1，在安装完
jar包并添加依赖后，需要重新导入Maven项目（点击Maven面板的刷新按钮）。
- 检查项目的
运行配置：确保
运行的是
包含所有依赖的
jar包（如果用方法2打
包后的
jar包），或者确保在
运行配置中
包含了该
jar包。
另外，
错误信息中提到了`org/slf4j/LoggerFactory`，这可能是缺少slf4j
-api的
jar包。如果你引入的本地
jar包依赖了slf4j，那么你还需要确保项目中也
包含了slf4j
-api的依赖。可以在pom
.xml中添加：
```xml
<dependency>
<groupId>org
.slf4j</groupId>
<artifactId>slf4j
-api</artifactId>
<version>1
.7
.30</version> <!
-- 请根据实际情况选择版本
-->
</dependency>
```
总结：推荐优先使用方法1（安装到本地仓库），因为它更符合Maven的依赖管理机制。如果
jar包是私有的且不能安装到本地仓库，则使用方法2并配置打
包插件。
如果问题仍然存在，请检查是否因为多个版本冲突导致，或者是否在正确的模块中添加了依赖（多模块项目需要注意依赖添加的位置）。
§§相关问题§§
1
. 如何在
IntelliJ IDEA中重新导入Maven项目？
2
. 如何解决Maven依赖冲突？
3
. 如何使用maven
-shade
-plugin打
包包含所有依赖的
jar？
4
. 如何在多模块Maven项目中添加依赖？
</think>
### 解决
IntelliJ IDEA 中 Maven 引入本地
JAR 包报错 `
NoClassDefFoundError`
#### 问题原因
`
java.lang.NoClassDefFoundError` 表明 JVM 在
运行时找不到类定义，常见于：
1
. **依赖未正确引入**：本地
JAR 未加入
编译路径或
运行时类路径
2
. **作用域配置
错误**：Maven 的 `<scope>` 配置导致依赖未打
包
3
. **打
包遗漏**：构建时未
包含本地
JAR（常见于 `system` 作用域）
---
### 解决方案（逐步操作）
#### ✅ 方法 1：将本地
JAR 安装到 Maven 本地仓库（推荐）
1
. **安装
JAR 到本地仓库**
在终端执行（替换参数）：
```bash
mvn install:install
-file \
-Dfile=路径/your
-lib
.jar \
-DgroupId=com
.example \
-DartifactId=custom
-lib \
-Dversion=1
.0 \
-Dpackaging=
jar
```
- 📍 示例：若
JAR 位于 `libs/example
.jar`，则 `
-Dfile=libs/example
.jar`
2
. **在 `pom
.xml` 中添加依赖**
```xml
<dependency>
<groupId>com
.example</groupId>
<artifactId>custom
-lib</artifactId>
<version>1
.0</version>
</dependency>
```
3
. **重新加载 Maven 项目**
- 在
IDEA 中右键点击 `pom
.xml` → **Maven** → **Reload Project**
---
#### ✅ 方法 2：使用 `system` 作用域 + 打
包配置
1
. **在 `pom
.xml` 声明依赖**
```xml
<dependency>
<groupId>com
.example</groupId>
<artifactId>local
-lib</artifactId>
<version>1
.0</version>
<scope>system</scope>
<systemPath>${project
.basedir}/libs/your
-lib
.jar</systemPath>
</dependency>
```
2
. **配置打
包插件（关键步骤）**
在 `pom
.xml` 的 `<build>` 中添加：
```xml
<plugins>
<!
-- 确保
包含 system 作用域的依赖
-->
<plugin>
<groupId>org
.apache
.maven
.plugins</groupId>
<artifactId>maven
-assembly
-plugin</artifactId>
<version>3
.3
.0</version>
<configuration>
<descriptorRefs>
<descriptorRef>
jar-with
-dependencies</descriptorRef>
</descriptorRefs>
</configuration>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
```
3
. **重新构建项目**
```bash
mvn clean package
```
- 运行生成的 `target/your
-app
-jar-with
-dependencies
.jar`
---
### 排查技巧
1
. **检查依赖树**
在终端执行：
```bash
mvn dependency:tree
```
确认本地
JAR 是否出现在输出中。
2
. **验证打
包结果**
解压
生成的
JAR 文件，检查是否
包含目标类：
```bash
jar tf target/your
-app
.jar | grep YourMissingClass
```
3
. **
IDEA 配置检查**
- **File** → **Project Structure** → **Libraries**：确认
JAR 已添加
- **Run/Debug Configurations** → **Classpath**：检查
运行时类路径
---
### 常见陷阱
- **
JAR 路径问题**：`systemPath` 必须使用绝对路径或 `${project
.basedir}` 开头
- **版本冲突**：若同时存在多个版本依赖，使用 `mvn dependency:tree` 排查
- **作用域误解**：`provided` 作用域的依赖不会打
包（如 Servlet API）
> 💡 如果
报错涉及 `slf4j`（如引用中的 `org/slf4j/LoggerFactory`），可能是传递依赖缺失，需显式添加：
> ```xml
> <dependency>
> <groupId>org
.slf4j</groupId>
> <artifactId>slf4j
-api</artifactId>
> <version>1
.7
.32</version>
> </dependency>
> ```
---
### 附加建议
- **优先使用 Nexus 私有仓库**：长期项目建议通过 Nexus 管理私有依赖
- **版本一致性**：确保本地
JAR 的版本号与 `pom
.xml` 声明完全一致
- **清理缓存**：执行 `mvn clean` 并重启
IDEA 避免缓存问题
本文详细介绍了如何在Ubuntu 20.04上使用IntelliJ IDEA（版本2020.03.01）创建并生成可运行的JAR包，包括配置Artifacts、指定主类和MANIFEST.MF路径。同时，文章指出在添加新依赖后必须更新JAR配置，以避免运行时出现`java.lang.NoClassDefFoundError`错误。
3. 再在弹出窗口中选择左侧Artifacts，点击“+”号，弹出窗口中选择JAR-->From modules with dependencies。
扫一扫
1025
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
