You need to enable JavaScript to run this app. Spigot插件启动时循环函数卡死,如何解决同步在线玩家至API的问题?
优惠活动
大模型
产品
解决方案
定价
更多

Spigot插件启动时循环函数卡死,如何解决同步在线玩家至API的问题?

插件启动卡死核心原因及修复方案

核心问题定位

  • 主线程阻塞(最致命诱因)
    Minecraft 插件的 onEnable() 启用逻辑默认运行在服务器主线程上。如果直接在 onEnable() 中调用该 playerListLoop() 方法,整个循环会完全占用主线程:循环内的阻塞式HTTP请求、Thread.sleep(5*1000) 都会暂停服务器所有核心逻辑(比如tick运算、玩家操作响应、区块加载),直接表现为服务器卡死假死。
  • 死循环逻辑错误
    代码中循环条件写为 while (on = true):这里是赋值运算符而非相等判断,无论后续如何修改 on 的值,循环都会永久运行,没有任何退出机制,哪怕放到独立线程也会持续占用资源,插件禁用、服务器关闭时也无法停止同步任务。
  • 阻塞IO无资源释放机制
    HttpURLConnection 本身是阻塞式实现,原代码没有做插件卸载时的任务终止逻辑,极易出现线程泄漏、网络连接资源未释放的问题。
  • 隐性并发风险
    如果代码中的 connection 是全局静态变量,多线程下会出现连接错乱、读写异常;手动拼接JSON字符串的方式遇到status字段包含双引号时,会直接触发JSON格式错误。

可直接落地的修复方案

1. 用MC插件自带调度器把同步任务移出主线程

绝对不要手动写死循环、自定义Thread跑常驻任务,使用Bukkit/Spigot/Paper提供的异步周期调度器:

// 在onEnable()中启动任务,不要直接调用循环方法
this.getServer().getScheduler().runTaskTimerAsynchronously(this, () -> {
    // 提前在同步上下文获取玩家数,避免异步访问游戏状态的并发问题
    int onlinePlayers = this.getServer().getOnlinePlayers().size();
    String status = "online"; // 替换为你实际的服务状态逻辑
    sendSyncRequest(status, onlinePlayers);
}, 0L, 100L); // 延迟0 tick启动,每100tick=5秒执行一次(20tick=1秒)

2. 重写单次同步逻辑,去掉死循环

将原循环方法改造为单次执行的请求方法,删除所有while循环、Thread.sleep逻辑:

public static void sendSyncRequest(String status, int onlinePlayers) {
    HttpURLConnection connection = null;
    try {
        URL url = new URL("http://192.168.1.14:3000");
        connection = (HttpURLConnection) url.openConnection();
        connection.setRequestMethod("POST");
        connection.setConnectTimeout(5000);
        connection.setReadTimeout(5000);
        connection.setRequestProperty("Content-Type", "application/json");
        connection.setRequestProperty("x-_id", "518747784");
        connection.setRequestProperty("x-api-key", "7");
        connection.setDoOutput(true);

        // 转义status中的双引号,避免JSON格式错误
        String safeStatus = status.replace("\"", "\\\"");
        String urlParameters = String.format("{\"survival\": {\"status\": \"%s\", \"players\": \"%d\"}}", 
            safeStatus, onlinePlayers);
        byte[] postData = urlParameters.getBytes(StandardCharsets.UTF_8);

        try (DataOutputStream wr = new DataOutputStream(connection.getOutputStream())){
            wr.write(postData);
        }

        // 按需保留响应读取逻辑
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        if (connection != null) {
            connection.disconnect();
        }
    }
}

3. 增加关闭时的任务释放逻辑

在插件的 onDisable() 方法中取消所有绑定当前插件的调度任务,避免服务器关闭时残留后台线程:

@Override
public void onDisable() {
    this.getServer().getScheduler().cancelTasks(this);
}

原理说明

Minecraft 服务器主线程是单线程运行的,只要有任意操作阻塞超过几毫秒就会出现TPS掉零、操作无响应的表现。原代码的循环逻辑加上5秒sleep、最长10秒的HTTP超时,会让主线程直接卡15秒以上,必然出现启动阶段卡死的问题。使用官方调度器做异步周期任务,既不会占用主线程资源,也能自动适配服务器的线程管理逻辑,不需要自己手动维护循环和睡眠逻辑。

内容的提问来源于stack exchange,提问作者Pointy Kone

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 02:57:00