Maven命令行运行Kafka Streams项目报ClassNotFoundException求助

这个问题我太熟悉了——本质是Maven默认打包的jar不包含第三方依赖库导致的：IntelliJ会自动把项目所有依赖都加入运行时的classpath，但你用java -cp直接跑自己的jar时，JVM只能找到你写的代码，找不到Kafka Streams这些依赖类，所以抛出了NoClassDefFoundError。下面给你三种实用的解决方案：

方案1：用Maven Shade Plugin构建Fat Jar（最推荐） #

这个插件会把你的代码和所有依赖打包成一个独立的"胖jar"，运行时不用再操心依赖路径。修改你的pom.xml，在<build><plugins>节点里添加Shade插件：

<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>
                    <!-- 指定主类，这样可以直接用java -jar运行 -->
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>pega</mainClass>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

然后重新执行打包命令：

mvn clean package

打包完成后，用下面的命令运行（不用再写-cp指定路径）：

java -jar target/s_order_project-1.0-SNAPSHOT.jar

方案2：手动指定依赖的Classpath #

如果你不想打包成胖jar，可以用Maven的Dependency插件把所有依赖下载到指定目录，再运行时手动把它们加入classpath：

先在pom.xml的<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>

执行mvn clean package后，target/lib目录里会出现所有依赖jar。然后按系统类型执行运行命令：

• Linux/macOS用:分隔classpath：

java -cp target/s_order_project-1.0-SNAPSHOT.jar:target/lib/* pega

• Windows用;分隔classpath：

java -cp target\s_order_project-1.0-SNAPSHOT.jar;target\lib\* pega

方案3：用Maven Exec Plugin直接运行 #

这个方法不用自己处理打包和classpath，直接让Maven帮你管理依赖并运行：

在pom.xml的<plugins>里添加Exec插件：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.1.0</version>
    <configuration>
        <mainClass>pega</mainClass>
    </configuration>
</plugin>

然后直接执行命令运行项目：

mvn exec:java

最后提个小建议：你的类名pega是小写，虽然Java语法允许，但不符合类名大驼峰的命名规范，建议改成Pega，这样更易读也避免潜在问题。

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