Maven项目IDEA运行正常，命令行启动报java.lang.NoClassDefFoundError求助

嘿，我碰到过一模一样的问题！你这明显是命令行里的类路径配置出问题了——IntelliJ IDEA会自动帮你把所有依赖都塞进类路径，但手动敲命令就得自己处理细节。先把你的问题梳理清楚：

我有一个Maven项目，在IntelliJ IDEA中运行完全正常，但通过命令行启动时出现java.lang.NoClassDefFoundError错误。我执行的命令依次为：

• mvn clean install
• mvn dependency:copy-dependencies
• cd target/
• java -cp Flux-1.0-SNAPSHOT.jar:dependency SocketServer

以下是我的pom.xml文件内容：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>groupId</groupId>
    <artifactId>Flux</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!-- 剩余内容未提供 -->

问题根源 #

你当前的启动命令里，类路径只写了dependency目录，但Java不会自动加载目录下的所有JAR包，必须明确指定；另外不同操作系统的类路径分隔符也不一样——你用的:是Linux/macOS的，Windows得用;。

解决办法 #

方法1：修正类路径命令（快速临时解决） #

根据你的操作系统调整命令：

• Linux/macOS：用*匹配dependency下所有JAR

  java -cp Flux-1.0-SNAPSHOT.jar:dependency/* SocketServer
  

• Windows：换成;分隔符，同时匹配所有JAR

  java -cp Flux-1.0-SNAPSHOT.jar;dependency\* SocketServer
  

方法2：打包成可执行胖JAR（推荐长期方案） #

手动处理类路径太麻烦，不如用Maven插件把项目和所有依赖打包成一个独立的可执行JAR，以后启动只需要一条命令：

1. 在你的pom.xml的<build>节点下添加Assembly插件配置：

<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-assembly-plugin</artifactId>
        <version>3.6.0</version>
        <configuration>
            <descriptorRefs>
                <descriptorRef>jar-with-dependencies</descriptorRef>
            </descriptorRefs>
            <archive>
                <manifest>
                    <!-- 这里替换成你的主类全限定名，比如com.example.SocketServer -->
                    <mainClass>SocketServer</mainClass>
                </manifest>
            </archive>
        </configuration>
        <executions>
            <execution>
                <id>make-assembly</id>
                <phase>package</phase>
                <goals>
                    <goal>single</goal>
                </goals>
            </execution>
        </executions>
    </plugin>
</plugins>

2. 执行打包命令：

mvn clean package

3. 打包完成后，target目录下会生成类似Flux-1.0-SNAPSHOT-jar-with-dependencies.jar的文件，直接启动：

java -jar Flux-1.0-SNAPSHOT-jar-with-dependencies.jar

方法3：用Maven Exec插件直接运行 #

如果不想打包，也可以用Exec插件让Maven帮你处理类路径，直接运行项目：

1. 在pom.xml的<build>节点下添加Exec插件配置：

<plugins>
    <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>exec-maven-plugin</artifactId>
        <version>3.1.0</version>
        <configuration>
            <!-- 替换成你的主类全限定名 -->
            <mainClass>SocketServer</mainClass>
        </configuration>
    </plugin>
</plugins>

2. 直接运行项目：

mvn exec:java

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