使用MongoDB的Java密码管理器通过bat启动时出现java.lang.NoClassDefFoundError求助

看起来你遇到的问题非常典型——本地IDE能正常跑，但单独用bat启动jar时找不到MongoDB的客户端类，核心原因是你的jar包只包含了自己写的代码，没把MongoDB驱动这类依赖打包进去。

问题原因拆解 #

VSCode里运行项目时，Maven会自动把所有依赖的jar包（比如mongodb-driver-sync）加入到运行时的类路径中，所以能找到com.mongodb.client.MongoClients类。但你当前用的passwordManager-1.0-SNAPSHOT.jar是个「瘦jar」，只包含你自己的业务代码，没有嵌入任何外部依赖，单独运行时JVM找不到这些缺失的类，就抛出了NoClassDefFoundError。

解决方案：用Maven Shade插件构建「胖Jar」 #

好在你的pom.xml里已经配置了maven-shade-plugin，这个插件专门用来把项目代码和所有依赖打包成一个包含完整运行环境的「胖Jar」（Fat Jar），只是可能你没正确触发它的构建流程。按以下步骤操作：

1. 重新构建生成胖Jar
   打开终端，切换到你的项目根目录，执行以下命令：

   mvn clean package
   

   这个命令会先清理之前的构建产物，再执行打包流程。Shade插件会在target目录下生成一个带-shaded后缀的Jar包（比如passwordManager-1.0-SNAPSHOT-shaded.jar），这个Jar就是包含了所有依赖的胖Jar，体积会比原来的瘦Jar大很多，因为嵌入了MongoDB驱动的所有类。

2. 修改bat文件的启动命令
   把bat里的启动命令改成直接运行这个胖Jar即可——因为Shade插件已经在Jar的Manifest文件里指定了主类，不用再手动指定类路径和主类：

   java -jar target/passwordManager-1.0-SNAPSHOT-shaded.jar
   

   （如果你的胖Jar名字不是这个，替换成target目录里实际生成的带shaded后缀的文件名就行）

额外排查：确保Shade插件生效 #

如果执行mvn clean package后没生成胖Jar，大概率是因为你的Shade插件配置放在了pluginManagement节点下——这个节点只是用来统一管理插件配置，不会自动触发执行。你需要把Shade插件的配置移到build下的plugins节点中，修改后的pom.xml的build部分大概是这样：

<build>
  <pluginManagement>
    <!-- 保留原来的pluginManagement内容，比如maven-compiler-plugin、maven-jar-plugin的配置 -->
  </pluginManagement>
  <plugins>
    <!-- 添加Shade插件到plugins节点，确保Maven打包时触发它 -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.1.0</version>
      <executions>
        <execution>
          <phase>package</phase>
          <goals>
            <goal>shade</goal>
          </goals>
          <configuration>
            <filters>
              <filter>
                <artifact>*:*</artifact>
                <excludes>
                  <exclude>META-INF/*.SF</exclude>
                  <exclude>META-INF/*.DSA</exclude>
                  <exclude>META-INF/*.RSA</exclude>
                </excludes>
              </filter>
            </filters>
            <transformers>
              <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                <manifestEntries>
                  <Main-Class>org.mongodb.logic.Main</Main-Class>
                  <Build-Number>1</Build-Number>
                </manifestEntries>
              </transformer>
            </transformers>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

修改后再执行mvn clean package，就能正确生成胖Jar了。

这样调整后，你的bat文件就能正常启动密码管理器，不会再出现找不到MongoDB类的错误啦。

备注：内容来源于stack exchange，提问作者Bootfahrer