使用Java -jar命令运行时遭遇NoClassDefFoundError问题求助

我来帮你拆解这个问题——这其实是Java用-jar启动时的类路径规则导致的常见坑！

核心原因 #

当你使用java -jar program.jar启动程序时，JVM有两个关键行为：

1. 完全忽略命令行中的-cp/-classpath参数：不管你在命令行里写了多少类路径，JVM都不会用，它只会看program.jar里META-INF/MANIFEST.MF的配置。
2. 清单文件的Class-Path有严格格式要求：
   • 它默认是相对路径，相对于你执行java命令时的当前工作目录，不是Jar文件的位置，也不是直接写绝对路径（除非用JVM能识别的URL格式）。
   • 多个依赖用空格分隔，不能有换行或特殊符号。
   • Windows下的绝对路径不能直接写c:\BB\utility.jar，得转成URL格式（比如file:///C:/BB/utility.jar）。

而你用java -cp c:\AA\program.jar;c:\BB\utility.jar app.Main能正常运行，是因为这种方式直接通过命令行指定了完整类路径，JVM会优先使用这个路径加载所有类，完全跳过清单文件的Class-Path配置。

解决办法 #

办法1：修正清单文件的Class-Path配置（推荐） #

打开program.jar里的META-INF/MANIFEST.MF文件，调整Class-Path的写法：

• 如果utility.jar在固定绝对路径：

  Main-Class: app.Main
  Class-Path: file:///C:/BB/utility.jar
  

  注意：路径里的反斜杠要改成正斜杠，开头是file:///（三个斜杠，对应Windows本地文件协议）。
• 如果能调整依赖的位置，比如把utility.jar放到c:\AA\lib目录下，用相对路径更灵活：

  Main-Class: app.Main
  Class-Path: lib/utility.jar
  

  这时候需要在c:\AA目录下执行java -jar program.jar（因为相对路径是相对于当前工作目录）。

办法2：用批处理简化指定主类的启动方式 #

既然指定主类的方式能正常运行，你可以写一个Windows批处理文件（比如run_program.bat），内容如下：

@echo off
java -cp "c:\AA\program.jar;c:\BB\utility.jar" app.Main

以后双击这个批处理就能直接启动程序，不用每次输长命令。

办法3：打包成包含所有依赖的"胖Jar" #

如果不想折腾类路径，可以把utility.jar里的类直接合并到program.jar中，生成一个独立的可执行Jar。比如用Maven的Shade插件（如果是Maven项目）：
在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>app.Main</mainClass>
              </transformer>
            </transformers>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

执行mvn package后，target目录下生成的Jar就是可以直接用java -jar运行的胖Jar，不需要额外依赖。

内容的提问来源于stack exchange，提问作者Tommy131313