更新Discord Bot时出现java.lang.NoClassDefFoundError问题求助

出现的错误 #

运行时先后抛出两个类找不到的错误：

Error: Main class cannot be initialized Cause: java.lang.NoClassDefFoundError: net/dv8tion/jda/api/EmbedBuilder

Exception in thread "main" java.lang.NoClassDefFoundError: net/dv8tion/jda/api/JDABuilder

pom.xml中的问题分析 #

你的pom.xml存在几个关键问题，导致依赖无法正确加载：

1. JCenter仓库已停止服务：配置的jcenter仓库已停止维护，无法正常拉取JDA等依赖包。
2. 重复的编译插件配置：声明了两个maven-compiler-plugin，冗余且版本（3.5.1）老旧，对Java9支持不完善。
3. 无效依赖：<groupId>com.google</groupId><artifactId>google</artifactId>为无效配置，会干扰依赖解析。
4. 循环自依赖：最后一个依赖引用自身项目，导致maven依赖解析异常，必须移除。
5. 版本不兼容：JDA版本为4.2.0，但配套的jda-utilities用的是3.0.5，两者版本不匹配引发类加载问题。

修正后的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>GamerSucht</groupId>
    <artifactId>GamerSucht</artifactId>
    <version>1.0-SNAPSHOT</version>

    <build>
        <sourceDirectory>src</sourceDirectory>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.11.0</version>
                <configuration>
                    <source>9</source>
                    <target>9</target>
                </configuration>
            </plugin>
            <!-- 添加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>
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <!-- 替换成你的主类全路径，比如com.yourpackage.Main -->
                                    <mainClass>你的主类全限定名</mainClass>
                                </transformer>
                            </transformers>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

    <repositories>
        <!-- 替换JCenter为可用仓库 -->
        <repository>
            <id>maven-central</id>
            <url>https://repo1.maven.org/maven2/</url>
        </repository>
        <repository>
            <id>dv8tion</id>
            <url>https://m2.dv8tion.net/releases</url>
        </repository>
    </repositories>

    <dependencies>
        <dependency>
            <groupId>net.dv8tion</groupId>
            <artifactId>JDA</artifactId>
            <version>4.2.0_247</version>
            <exclusions>
                <exclusion>
                    <groupId>club.minnced</groupId>
                    <artifactId>opus-java</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <!-- MySQL驱动 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.32</version>
        </dependency>
        <!-- SQLite驱动 -->
        <dependency>
            <groupId>org.xerial</groupId>
            <artifactId>sqlite-jdbc</artifactId>
            <version>3.40.1.0</version>
        </dependency>
        <!-- OSHI系统信息库 -->
        <dependency>
            <groupId>com.github.oshi</groupId>
            <artifactId>oshi-core</artifactId>
            <version>6.4.0</version>
        </dependency>
        <!-- JNA相关 -->
        <dependency>
            <groupId>net.java.dev.jna</groupId>
            <artifactId>jna-platform</artifactId>
            <version>5.12.1</version>
        </dependency>
        <dependency>
            <groupId>net.java.dev.jna</groupId>
            <artifactId>jna</artifactId>
            <version>5.12.1</version>
        </dependency>
        <!-- Lavaplayer音频库 -->
        <dependency>
            <groupId>com.sedmelluq</groupId>
            <artifactId>lavaplayer</artifactId>
            <version>1.3.63</version>
        </dependency>
        <!-- SLF4J日志实现 -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
            <version>2.0.5</version>
        </dependency>
        <!-- Guava工具库 -->
        <dependency>
            <groupId>com.google.guava</groupId>
            <artifactId>guava</artifactId>
            <version>31.1-jre</version>
        </dependency>
        <!-- JDA工具类，版本匹配JDA4.x -->
        <dependency>
            <groupId>com.jagrosh</groupId>
            <artifactId>jda-utilities</artifactId>
            <version>4.0.0</version>
        </dependency>
        <!-- RethinkDB驱动 -->
        <dependency>
            <groupId>com.rethinkdb</groupId>
            <artifactId>rethinkdb-driver</artifactId>
            <version>2.4.4</version>
        </dependency>
        <!-- JSON-Simple -->
        <dependency>
            <groupId>com.googlecode.json-simple</groupId>
            <artifactId>json-simple</artifactId>
            <version>1.1.1</version>
        </dependency>
        <!-- ExpiringMap -->
        <dependency>
            <groupId>net.jodah</groupId>
            <artifactId>expiringmap</artifactId>
            <version>0.5.10</version>
        </dependency>
        <!-- Reflections -->
        <dependency>
            <groupId>org.reflections</groupId>
            <artifactId>reflections</artifactId>
            <version>0.10.2</version>
        </dependency>
    </dependencies>
</project>

后续操作步骤 #

1. 替换pom.xml内容，将maven-shade-plugin中的<mainClass>替换为你Bot的主类全限定名（比如com.gamersucht.Main）。
2. 清理本地Maven缓存并重新安装依赖：

mvn clean install -U

3. 在IDE中重新加载Maven项目（比如IntelliJ的Reload All Maven Projects）。
4. 使用mvn package打包，运行生成的shaded jar包即可。

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