如何等待WildFly服务器重载完成并启动？

你遇到的问题是因为reload命令的CLI进程在发送重启指令后就会结束，所以waitFor()只能等待CLI命令执行完毕，而不是服务器重启完成。下面是两种可靠的解决方案：

方案一：使用WildFly CLI内置的wait-for命令 #

WildFly CLI提供了wait-for命令，可以等待服务器的特定状态或资源就绪，最常用的是等待管理端口绑定完成：

组合命令方式（一次执行） #

CliCommandBuilder cliCommandBuilder = ...
// 先执行reload，再等待管理端口就绪，超时60秒
cliCommandBuilder.setCommand("reload; wait-for(socket-binding=management-native,timeout=60000)");

Launcher.of(cliCommandBuilder)
    .inherit()
    .setRedirectErrorStream(true)
    .launch().waitFor();

分命令执行方式（更清晰） #

先执行重载命令，再单独执行等待命令：

// 执行重载
CliCommandBuilder reloadCmd = ...
reloadCmd.setCommand("reload");
Launcher.of(reloadCmd)
    .inherit()
    .setRedirectErrorStream(true)
    .launch().waitFor();

// 等待服务器管理端口就绪，超时60秒
CliCommandBuilder waitCmd = ...
waitCmd.setCommand("wait-for(socket-binding=management-native,timeout=60000)");
Launcher.of(waitCmd)
    .inherit()
    .setRedirectErrorStream(true)
    .launch().waitFor();

wait-for的参数说明：

• socket-binding=management-native：等待默认的本地管理端口（9990）绑定完成
• timeout=60000：设置超时时间为60秒，超过时间会抛出异常

方案二：自定义轮询检测逻辑 #

如果不想依赖CLI的wait-for，可以自己编写代码轮询检测服务器状态：

检测管理端口是否可连接 #

import java.net.Socket;

public static void waitForWildFlyReady(String host, int port, long timeoutMs) throws InterruptedException {
    long start = System.currentTimeMillis();
    while (System.currentTimeMillis() - start < timeoutMs) {
        try (Socket socket = new Socket(host, port)) {
            // 连接成功，说明服务器已启动完成
            return;
        } catch (Exception ignored) {
            // 连接失败，等待1秒后重试
            Thread.sleep(1000);
        }
    }
    throw new RuntimeException("WildFly未在" + timeoutMs + "毫秒内启动完成");
}

// 使用示例
waitForWildFlyReady("localhost", 9990, 60000);

检测健康检查端点（如果有部署） #

如果你的应用部署了健康检查端点（比如MicroProfile Health的/health），可以通过HTTP请求检测：

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public static void waitForWildFlyHealth(String healthEndpoint, long timeoutMs) throws InterruptedException {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(healthEndpoint))
            .GET()
            .build();

    long start = System.currentTimeMillis();
    while (System.currentTimeMillis() - start < timeoutMs) {
        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
            if (response.statusCode() == 200) {
                // 健康检查通过，服务器就绪
                return;
            }
        } catch (Exception ignored) {
            Thread.sleep(1000);
        }
    }
    throw new RuntimeException("WildFly健康检查未在" + timeoutMs + "毫秒内通过");
}

// 使用示例
waitForWildFlyHealth("http://localhost:8080/health", 60000);

推荐方案 #

优先使用方案一，因为wait-for是WildFly官方提供的工具，能准确识别服务器的就绪状态，避免自定义轮询可能出现的边缘情况（比如端口已绑定但应用未完全启动）。

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