Spring AI Alibaba 服务多端口注册问题分析与解决方案

问题背景

在微服务架构中，服务注册与发现是核心组件之一。Spring AI Alibaba 项目中的 nacos-mcp-server 模块提供了与 Nacos 服务注册中心集成的能力。然而，当服务同时配置了 Actuator 监控端点并使用独立端口时，会出现服务注册端口错误的问题。

问题现象

开发者在项目中同时引入了以下组件：

1. spring-ai-alibaba-starter-nacos-mcp-server
2. spring-boot-starter-actuator

当通过配置 management.server.port=7920 为 Actuator 指定不同于主服务的端口后，Nacos 中注册的服务端口会出现错误。通过日志分析发现，服务注册事件被触发了两次，其中第二次注册使用了错误的端口号。

技术原理分析

这个问题本质上源于 Spring Boot 的事件监听机制和服务注册逻辑的交互：

1. 多端口服务场景：当配置了 management.server.port 时，Spring Boot 会创建两个独立的 Web 服务器实例 - 一个用于主业务逻辑（默认端口8080），另一个专用于 Actuator 端点（如配置的7920）。

2. 服务注册触发机制：Spring Cloud 的服务注册通常监听 WebServerInitializedEvent 事件，每当一个 Web 服务器初始化完成时都会触发该事件。

3. 重复注册问题：在上述场景中，由于有两个 Web 服务器实例，会导致服务注册逻辑被触发两次。如果注册逻辑没有正确处理多实例情况，就可能使用后初始化的服务器端口（通常是 Actuator 端口）进行注册。

解决方案

针对这个问题，可以采取以下几种解决方案：

方案一：过滤注册事件

在服务注册逻辑中增加判断条件，只响应主业务端口的 Web 服务器初始化事件：

@EventListener
public void onApplicationEvent(WebServerInitializedEvent event) {
    if (event.getWebServer() instanceof TomcatWebServer) {
        TomcatWebServer webServer = (TomcatWebServer) event.getWebServer();
        if (webServer.getPort() == this.port) {  // this.port是主服务端口
            // 执行注册逻辑
        }
    }
}

方案二：延迟注册

通过适当延迟注册，确保使用正确的端口信息：

@EventListener(ContextRefreshedEvent.class)
public void registerService() {
    // 获取当前环境中的服务器端口
    String port = environment.getProperty("local.server.port");
    // 执行注册逻辑
}

方案三：明确指定注册端口

在配置中显式指定要注册的端口，忽略自动发现：

spring:
  cloud:
    nacos:
      discovery:
        port: 8080  # 明确指定注册端口

最佳实践建议

1. 生产环境配置：对于生产环境，建议采用方案三明确指定注册端口，避免自动发现可能带来的不确定性。

2. 监控端口隔离：保持 Actuator 端口与业务端口的分离是一个良好的实践，可以增强系统安全性。

3. 版本兼容性：升级到最新版本的 Spring Cloud Alibaba 组件，该问题在后续版本中可能已被修复。

4. 日志监控：实现服务注册过程的详细日志记录，便于快速发现和诊断类似问题。

总结

多端口服务注册问题是微服务架构中常见的配置问题之一。通过理解 Spring Boot 的事件机制和服务注册原理，开发者可以更好地掌控服务注册行为。在实际项目中，建议根据具体需求选择合适的解决方案，并建立相应的监控机制以确保服务发现的可靠性。