Spring Gateway与Sa-Token冲突致服务无法注册到Nacos求助

同时使用Spring Gateway与Sa-Token时，服务无法注册到Nacos。移除Gateway或Sa-Token任意一个组件，应用都能成功注册到Nacos。移除配置中的routes部分后，应用可成功注册，但会丢失路由功能，该如何解决？

版本信息 #

• Java: 17
• Spring Boot: 3.0.2
• spring-cloud-starter-alibaba-nacos-discovery: 2022.0.0.0-RC
• Spring Cloud: 2022.0.0-RC
• sa-token-reactor-spring-boot3-starter: 1.37.0

应用配置（application.yml） #

spring:
  application:
    name: gateway-service
  cloud:
    nacos:
      discovery:
        group: vevss
        username: nacos
        password: nacos
        server-addr: 127.0.0.1:8848
        namespace: public
    gateway:
      discovery:
        locator:
          enabled: true
          lower-case-service-id: true
      # 移除以下部分后服务可成功注册，但丢失路由功能
      routes:
        - id: auth-service
          uri: lb://auth-service
          predicates:
            - Path=/login
            - Path=/auth/doc.html
          filters:
            - RewritePath=/auth/doc.html, /doc.html

        - id: user-service
        # 其他路由配置...

sa-token:
  token-name: satoken
  timeout: 2592000
  active-timeout: -1
  is-concurrent: true
  is-share: true
  token-style: uuid
  is-log: false

可能的解决思路 #

1. 补全不完整的路由配置 #

你的user-service路由只定义了id，缺少uri、predicates等核心配置项，这会导致Gateway初始化失败，进而阻断Nacos注册流程。先补全所有路由的完整配置，确保语法和逻辑无错误。

2. 调整Sa-Token初始化时机 #

Sa-Token的Reactor版本可能在Nacos注册完成前就完成了上下文加载，引发冲突。可以在启动类添加@DependsOn("nacosServiceRegistry")注解，强制Nacos注册逻辑优先执行：

@SpringBootApplication
@DependsOn("nacosServiceRegistry")
public class GatewayServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(GatewayServiceApplication.class, args);
    }
}

3. 排除Sa-Token冲突的自动配置 #

Sa-Token的starter可能引入了与Gateway（WebFlux环境）不兼容的WebMVC配置，尝试在启动类排除相关自动配置：

@SpringBootApplication(exclude = {SaTokenWebMvcAutoConfiguration.class})

如果无效，可以查看Sa-Token的自动配置类清单，针对性排除不适配WebFlux的配置项。

4. 开启日志定位根因 #

添加日志配置，查看Nacos注册失败或Gateway初始化的具体异常：

logging:
  level:
    com.alibaba.nacos.client.naming: DEBUG
    org.springframework.cloud.gateway: DEBUG
    cn.dev33.satoken: DEBUG

通过日志确认是Nacos注册请求未发送、还是Gateway启动抛出异常导致服务未完成注册。

5. 升级组件版本 #

当前使用的Spring Cloud和Nacos Discovery均为RC预览版，稳定性不足。建议升级到正式版：

• 将spring-cloud-starter-alibaba-nacos-discovery升级到2022.0.0.1（对应Spring Cloud 2022.0.0.1正式版）
• 将Sa-Token升级到最新的Spring Boot3适配稳定版（如1.38.x系列），修复已知兼容性问题

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