如何获取Quarkus管理接口随机端口用于RestAssured测试

下面提供几种直接可行的方法，解决你迁移到Quarkus 3后，管理接口随机端口无法被RestAssured识别的问题：

方法1：直接使用QuarkusTest内置的管理客户端 #

这是最省心的方式，@QuarkusTest提供了managementClient()方法，自动帮你绑定管理接口的随机端口和默认路径前缀（/q），无需手动处理端口：

@QuarkusTest
public class CustomHealthCheckTest {

    @Test
    void testCustomHealthCheck() {
        managementClient()
            .get().path("/health") // 直接写管理接口的子路径，无需加/q
            .then()
            .statusCode(200);
    }
}

方法2：注入实际分配的管理测试端口 #

通过@ConfigProperty注入Quarkus实际分配的随机管理端口，然后手动配置RestAssured：

@QuarkusTest
public class CustomHealthCheckTest {

    @Inject
    @ConfigProperty(name = "quarkus.management.test-port")
    private Integer managementPort;

    @Test
    void testCustomHealthCheck() {
        given()
            .port(managementPort)
            .basePath("/q") // 管理接口默认前缀
        .when()
            .get("/health")
        .then()
            .statusCode(200);
    }
}

方法3：全局配置RestAssured端口 #

如果多个测试用例都需要访问管理接口，可以在测试类静态代码块中全局配置RestAssured的端口和基础路径：

@QuarkusTest
public class CustomHealthCheckTest {

    static {
        // 从配置中获取实际分配的管理测试端口
        Integer managementPort = ConfigProvider.getConfig()
            .getValue("quarkus.management.test-port", Integer.class);
        RestAssured.baseURI = "http://localhost";
        RestAssured.port = managementPort;
        RestAssured.basePath = "/q";
    }

    @Test
    void testCustomHealthCheck() {
        given()
        .when()
            .get("/health")
        .then()
            .statusCode(200);
    }
}

前置配置要求 #

确保你的测试环境配置文件（如src/test/resources/application.properties）中已经开启管理接口并设置随机测试端口：

quarkus.management.enabled=true
quarkus.management.test-port=0

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