Minecraft Spigot/Paper插件整合Spring Boot报错及数据交互方案咨询

一、Spring Boot整合错误解决 #

1. 核心问题分析 #

出现java.lang.NoClassDefFoundError: org/springframework/boot/SpringApplication的原因有两个：

• 版本不兼容：Spring Boot 3.0.1要求Java 17及以上，但你的项目配置的是Java 8，导致类加载时出现兼容性问题。
• 依赖未打包：默认Maven打包的插件jar不包含依赖类，Spigot的插件类加载器无法找到Spring Boot的核心类。

2. 具体修复步骤 #

（1）调整Spring Boot版本

将spring-boot-starter-web的版本改为支持Java 8的2.x系列，比如2.7.15：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.7.15</version>
</dependency>

（2）替换打包插件，嵌入所有依赖

移除spring-boot-maven-plugin，改用maven-shade-plugin将所有依赖打包进插件jar（同时重定位依赖包，避免与其他插件的依赖冲突）：

<build>
    <plugins>
        <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>
                        <relocations>
                            <relocation>
                                <pattern>org.springframework</pattern>
                                <shadedPattern>com.sniklz.snikkzplugin.lib.springframework</shadedPattern>
                            </relocation>
                            <relocation>
                                <pattern>org.apache.commons</pattern>
                                <shadedPattern>com.sniklz.snikkzplugin.lib.apache.commons</shadedPattern>
                            </relocation>
                        </relocations>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

（3）优化Spring Boot启动配置

在SniklzPluginApp中指定端口，避免与Minecraft服务器或其他服务冲突，同时限制Spring Boot的初始化范围：

package com.sniklz.snikkzplugin;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.context.AnnotationConfigServletWebServerApplicationContext;

@SpringBootApplication
public class SniklzPluginApp {

    public static void start() {
        SpringApplication app = new SpringApplication(SniklzPluginApp.class);
        // 指定非默认端口，比如8081
        app.setDefaultProperties(java.util.Collections.singletonMap("server.port", "8081"));
        // 使用Servlet专用上下文，避免Spring Boot全局初始化影响Spigot
        app.setApplicationContextClass(AnnotationConfigServletWebServerApplicationContext.class);
        app.run();
    }
}

二、插件与外部站点通信的最佳方案 #

整合Spring Boot到Minecraft插件中过于笨重，会增加插件体积和服务器资源占用，推荐以下轻量方案：

1. 插件主动向外部发送数据（常用场景） #

直接使用轻量HTTP客户端发送请求，无需启动本地web服务：

• OkHttp：简洁高效的HTTP客户端，支持同步/异步请求，适合发送POST/GET数据。
• Apache HttpClient：功能全面，适合复杂请求场景。
• Java原生HttpURLConnection：无需额外依赖，适合简单请求。

示例（OkHttp发送POST请求）：

// 添加Maven依赖
<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.10.0</version>
</dependency>

// 发送请求代码
OkHttpClient client = new OkHttpClient();
RequestBody body = RequestBody.create(MediaType.parse("application/json"), "{\"playerName\":\"Steve\",\"action\":\"join\"}");
Request request = new Request.Builder()
        .url("https://your-external-site.com/api/player-log")
        .post(body)
        .build();

try (Response response = client.newCall(request).execute()) {
    if (!response.isSuccessful()) throw new IOException("请求失败，状态码：" + response.code());
    System.out.println("外部响应：" + response.body().string());
} catch (IOException e) {
    e.printStackTrace();
}

2. 外部站点主动调用插件接口 #

如果需要外部主动触发插件逻辑，使用轻量嵌入式web服务器：

• Spark Java：极简的嵌入式web框架，几行代码就能启动HTTP服务，占用资源极少。
• Netty：高性能NIO框架，适合自定义协议或高并发场景，但学习成本稍高。

示例（Spark Java启动服务）：

// 添加Maven依赖
<dependency>
    <groupId>com.sparkjava</groupId>
    <artifactId>spark-core</artifactId>
    <version>2.9.4</version>
</dependency>

// 在插件onEnable方法中启动服务
@Override
public void onEnable() {
    new Thread(() -> {
        Spark.port(8081);
        Spark.get("/api/online-players", (req, res) -> {
            return getServer().getOnlinePlayers().size();
        });
    }).start();
}

3. 双向实时通信（WebSockets） #

如果需要插件与外部站点实时双向通信，使用轻量WebSocket库：

• Java-WebSocket：轻量级WebSocket实现，支持客户端和服务器模式，无需额外依赖。
• Spark Java WebSockets：基于Spark的WebSocket扩展，使用简单。

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