Java maven 打包工程后java -cp 运行jar的某个类会报java.lang.ClassNotFoundException, 但是把这个类打成主类后直接运行jar就能运行

转载已于 2025-07-18 10:11:13 修改 · 142 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://www.doubao.com/

文章标签：

#java #jar #开发语言

于 2025-07-18 10:10:54 首次发布

Java 专栏收录该内容

66 篇文章

订阅专栏

参考 : 豆包

问题原因分析

你遇到的这个问题是Java类路径管理的典型问题。当使用java -cp和java -jar运行程序时，类路径的处理方式是不同的：

java -cp方式：
- 这种方式下，Java虚拟机(JVM)只会从你通过-cp参数指定的路径中查找类
- 如果你的应用依赖于其他JAR文件，必须在-cp参数中显式列出所有依赖的JAR文件
- 例如：java -cp your-application.jar:dependency1.jar:dependency2.jar com.yourcompany.MainClass
java -jar方式：
- 当使用java -jar运行JAR文件时，JVM会忽略-cp参数
- JVM会从JAR文件的META-INF/MANIFEST.MF文件中读取Class-Path属性，该属性定义了该JAR文件依赖的其他JAR文件
- 例如，MANIFEST.MF可能包含：Class-Path: dependency1.jar dependency2.jar

你遇到ClassNotFoundException的原因是：当使用java -cp时，你没有在类路径中包含应用依赖的所有JAR文件，而java -jar能够正确找到依赖是因为MANIFEST.MF中已经正确配置了依赖项。

解决方案

1. 手动指定完整的类路径

在使用java -cp运行时，确保包含所有依赖的JAR文件：

java -cp your-application.jar:path/to/dependency1.jar:path/to/dependency2.jar com.aliyun.emrs.test.cloud.SparkFenQuCloud

注意：

类路径中的JAR文件路径必须是正确的
在Windows系统上，路径分隔符使用分号;而不是冒号:

2. 使用Maven生成包含依赖的"胖JAR"

使用Maven插件将所有依赖打包到一个单独的JAR文件中，这样就不需要额外指定类路径：

在pom.xml中添加以下插件配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.4.1</version>
      <executions>
        <execution>
          <phase>package</phase>
          <goals>
            <goal>shade</goal>
          </goals>
          <configuration>
            <transformers>
              <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                <!-- 如果你需要指定主类，可以在这里配置 -->
                <!-- <mainClass>com.aliyun.emrs.test.cloud.SparkFenQuCloud</mainClass> -->
              </transformer>
            </transformers>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

然后使用以下命令打包：

mvn clean package

这会生成一个包含所有依赖的"uber JAR"，可以使用以下命令运行特定类：

java -cp target/your-application-jar-with-dependencies.jar com.aliyun.emrs.test.cloud.SparkFenQuCloud

3. 使用Maven的依赖插件提取依赖

如果你不想创建胖JAR，可以使用Maven依赖插件将所有依赖提取到一个目录，然后在运行时包含该目录：

在pom.xml中添加：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-dependency-plugin</artifactId>
      <version>3.6.0</version>
      <executions>
        <execution>
          <id>copy-dependencies</id>
          <phase>package</phase>
          <goals>
            <goal>copy-dependencies</goal>
          </goals>
          <configuration>
            <outputDirectory>${project.build.directory}/lib</outputDirectory>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

执行mvn clean package后，所有依赖会被复制到target/lib目录，然后可以这样运行：

java -cp target/your-application.jar:target/lib/* com.aliyun.emrs.test.cloud.SparkFenQuCloud

注意：target/lib/*语法在Java 8及以上版本有效，如果你使用的是Java 7或更早版本，需要显式列出所有JAR文件。

4. 自动生成类路径脚本

如果你不想手动维护类路径，可以编写一个脚本自动生成类路径：

#!/bin/bash

# 获取当前目录
DIR=$(dirname "$(realpath "$0")")

# 生成类路径（包含所有lib目录下的JAR文件）
CLASSPATH="$DIR/your-application.jar"
for jar in "$DIR"/lib/*.jar; do
    CLASSPATH="$CLASSPATH:$jar"
done

# 运行指定类
java -cp "$CLASSPATH" com.aliyun.emrs.test.cloud.SparkFenQuCloud

将上述脚本保存为run.sh（Linux/Mac）或run.bat（Windows），然后执行它来运行你的应用。