Java 打包成 JAR 包执行找不到依赖库中的类
在 Java 开发中，我们经常需要将项目打包成 JAR（Java ARchive）格式，以便于分发和部署。然而，在实际操作中，可能会遇到“找不到依赖库中的类”的问题。本文将详细介绍这一问题的原因，并给出解决方案和示例代码。
一、问题描述
当我们将 Java 项目打包成 JAR 文件时，通常会使用构建工具如 Maven 或 Gradle。这些工具可以自动管理项目的依赖库。然而，在某些情况下，打包后的 JAR 文件可能没有包含某些必要的依赖库，导致在运行时找不到相关的类。
例如，假设我们有一个 Java 项目使用了外部依赖库 Apache Commons Lang，但在将项目打包成 JAR 后，依赖库并未被包含。运行程序时，我们可能会遇到如下异常：
Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/lang3/StringUtils
二、问题原因
1. 依赖未包含在 JAR 中
有时，构建工具可能会配置不当，导致依赖库未被打包。例如，在 Maven 项目中，未在 pom.xml 中正确设置依赖的范围。
2. 运行时类路径设置不当
即使 JAR 中包含了所有依赖，运行程序时如果没有正确指定依赖库的路径，仍然会导致“找不到类”的问题。
三、解决方案
1. Maven 打包包含依赖
假设我们有一个 Maven 项目，用于处理字符串。首先，我们需要在 pom.xml 中声明对 Apache Commons Lang 的依赖：
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.12.0</version>
</dependency>
接下来，可以使用 Maven 的 maven-shade-plugin 来打包，包括所有依赖：
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>3.2.4</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
2. Gradle 打包包含依赖
如果使用 Gradle，可以在 build.gradle 文件中使用 shadow 插件将所有依赖打包到一个 JAR 文件中：
plugins {
id 'java'
id 'com.github.johnrengelman.shadow' version '7.1.0'
}
repositories {
mavenCentral()
}
dependencies {
implementation 'org.apache.commons:commons-lang3:3.12.0'
}
shadowJar {
archiveBaseName.set('my-application')
}
3. 正确的运行 JAR 文件
一旦成功打包，运行命令可能如下：
java -jar my-application-all.jar
这将确保你直接运行包含所有依赖的 JAR 文件。
四、运行时类路径设置
如果我们不想将所有依赖都打包到 JAR 中，可以选择将它们放在一个具体的目录中，并在执行 JAR 时设置类路径。例如：
java -cp "lib/*:my-app.jar" com.example.Main
在这个命令中，lib/* 包含了所有依赖库。
五、序列图示例
下面是一个字符串处理的功能示例的序列图：
sequenceDiagram
participant User
participant Main
participant StringUtils
User->>Main: invoke main()
Main->>StringUtils: call StringUtils.isEmpty()
StringUtils-->>Main: return boolean
Main-->>User: display result
六、状态图示例
此状态图展示了应用程序的基本状态变化：
stateDiagram
[*] --> Initializing
Initializing --> Running
Running --> Finished
Running --> Error
Error --> [*]
Finished --> [*]
结论
在 Java 开发中，打包成 JAR 后找不到依赖库中的类是一个常见问题。通过合理地配置构建工具并掌握运行时的类路径设置，可以有效地避免这一问题。希望本文能够帮助你更好地处理 Java 项目的打包和依赖管理，让开发过程更顺畅。如果你在使用 JAR 文件时仍然遇到问题，请仔细检查构建过程和类路径设置，确保每一步都正确无误。
