使用Maven构建JAR后执行java -jar报NoClassDefFoundError求助

问题现象 #

用Maven构建JAR后，执行java -jar命令抛出异常：

Exception in thread "main" java.lang.NoClassDefFoundError: com/toedter/calendar/JDateChooser

这是因为默认Maven打包的JAR只包含你自己的代码，不会把依赖的第三方类库打包进去，运行时JVM找不到这些依赖类。

解决办法 #

方法1：用Maven Shade插件打可执行胖JAR

在项目的pom.xml里添加Shade插件配置，它会把所有依赖的类都打包到同一个JAR里：

<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>
                    <configuration>
                        <!-- 替换成你的主类全路径，比如com.example.YourMainClass -->
                        <mainClass>你的主类全路径</mainClass>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

配置完成后，执行命令：

mvn clean package

打包完成后，target目录里会生成一个带-shaded后缀的JAR文件，直接用java -jar运行这个JAR即可。

方法2：手动指定classpath运行

如果不想打胖JAR，可以先通过Maven把依赖下载到本地（默认在~/.m2/repository），然后运行时指定所有依赖的路径：

# Windows系统
java -cp "your-project.jar;C:\Users\你的用户名\.m2\repository\com\toedter\jcalendar\对应的版本号\jcalendar-版本号.jar;其他依赖.jar" 你的主类全路径

# Linux/Mac系统
java -cp "your-project.jar:/home/你的用户名/.m2/repository/com/toedter/jcalendar/对应的版本号/jcalendar-版本号.jar:其他依赖.jar" 你的主类全路径

或者把所有依赖JAR放到项目的lib目录下，然后用通配符简化命令：

# Windows
java -cp "your-project.jar;lib/*" 你的主类全路径

# Linux/Mac
java -cp "your-project.jar:lib/*" 你的主类全路径

方法3：用Maven Assembly插件生成带依赖的包

在pom.xml里添加Assembly插件配置，它会生成一个包含JAR和依赖lib目录的压缩包：

<build>
    <plugins>
        <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>
                <archive>
                    <manifest>
                        <!-- 替换成你的主类全路径 -->
                        <mainClass>你的主类全路径</mainClass>
                    </manifest>
                </archive>
            </configuration>
            <executions>
                <execution>
                    <id>make-assembly</id>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

执行mvn clean package后，target目录会生成一个带-jar-with-dependencies后缀的JAR，直接运行即可。

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