如何在Vert.x中实现gRPC与HTTP服务器共用同一端口

当然可以实现——你不需要启动两个独立的服务器，因为Vert.x的gRPC服务器底层基于Vert.x HttpServer，而这个HttpServer本身支持同时处理HTTP/1.x（健康检查）和HTTP/2（gRPC）流量。之前的端口冲突是因为你尝试启动两个绑定同一端口的独立服务，正确的做法是复用gRPC服务器关联的HttpServer来处理健康检查请求。

具体实现方案 #

方式1：直接给gRPC的HttpServer添加请求处理器

Vertx vertx = Vertx.vertx();

// 实例化你的gRPC服务
YourGrpcServiceImpl grpcService = new YourGrpcServiceImpl();

// 构建gRPC服务器
VertxServerBuilder serverBuilder = VertxServerBuilder.forPort(vertx, 8080);
serverBuilder.addService(grpcService);

serverBuilder.build().start(startResult -> {
    if (startResult.succeeded()) {
        // 获取gRPC服务器绑定的HttpServer实例
        HttpServer httpServer = startResult.result().httpServer();
        
        // 添加健康检查路由
        httpServer.requestHandler(req -> {
            if ("/health".equals(req.path())) {
                req.response()
                   .setStatusCode(200)
                   .putHeader("Content-Type", "text/plain")
                   .end("OK");
            }
        });
        
        System.out.println("gRPC服务与健康检查接口已在8080端口启动");
    } else {
        System.err.println("服务器启动失败: " + startResult.cause().getMessage());
    }
});

方式2：使用Vert.x Router管理HTTP路由（更适合复杂场景）

如果后续需要添加更多HTTP接口，使用Router会更便于管理：

Vertx vertx = Vertx.vertx();
Router router = Router.router(vertx);

// 配置健康检查路由
router.get("/health").handler(ctx -> {
    ctx.response()
       .setStatusCode(200)
       .end("OK");
});

// 实例化gRPC服务
YourGrpcServiceImpl grpcService = new YourGrpcServiceImpl();

// 构建gRPC服务器，将Router关联到底层HttpServer
VertxServerBuilder serverBuilder = VertxServerBuilder.forPort(vertx, 8080);
serverBuilder.addService(grpcService);
serverBuilder.httpServerOptions(options -> {
    options.setRequestHandler(router);
});

serverBuilder.build().start(startResult -> {
    if (startResult.succeeded()) {
        System.out.println("服务已在8080端口启动");
    } else {
        startResult.cause().printStackTrace();
    }
});

核心原理 #

Vert.x的HttpServer默认支持HTTP/1.x和HTTP/2双协议，gRPC请求会自动走HTTP/2通道，而LB的健康检查HTTP请求会走HTTP/1.x通道，底层服务器会自动区分并分发处理，无需额外配置协议切换。

注意事项 #

• 无需单独启动HttpServer，只需要启动gRPC服务器即可，避免端口冲突
• 确保健康检查的路由路径与LB配置的路径一致（比如/health、/ready等）
• Vert.x默认开启HTTP/1.x和HTTP/2支持，无需额外配置；如果需要自定义协议参数，可以在httpServerOptions中调整

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