nacos-discovery和websocket依赖兼容问题,导致NacosWatch获取错误的TaskScheduler

本文介绍了在将注册中心从其他服务切换到Nacos时遇到的问题。项目在引入Nacos-discovery依赖后,login模块启动失败,原因是Spring Boot的websocket依赖导致TaskScheduler获取错误。通过debug发现,由于NoOpScheduler匹配导致问题。解决方案包括使用@Primary注解或关闭NacosWatch。作者还分享了在提issues过程中的小插曲,提醒开发者注意社区和版本兼容性问题。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

一、问题描述

最近公司准备把注册中心换为nacos,手头的项目再一次成为小白鼠。nacos作为注册中心,项目的login模块新引入nacos-discovery依赖启动失败:
在这里插入图片描述

版本依赖:
(1)springboot版本2.0.3.RELEASE
(2)spring-boot-starter-websocket版本2.0.3.RELEASE(以下简称为websocket
(3)spring-cloud-starter-alibaba-nacos-discovery版本2.0.3.RELEASE

二、解决思路

项目一共有两个模块login和security,security正常启动,唯独login启动失败(配置文件中nacos配置属性相同)。再由报错信息关键字"web.socket"和security未引入websocket依赖情况结合猜测,问题出现在login模块的websocket依赖。于是login模块去掉websocket依赖,启动成功。具体问题,经验不足,只能通过debug来排查。
1、security模块获取的TaskScheduler是什么?
根据login模块的报错提示,找到NoOpScheduler类,然后查看方法发现全是抛异常。
在这里插入图片描述

既然这样,看下能正常启动的security模块获取的TaskScheduler是什么。
在这里插入图片描述

初步猜测:引入websocket依赖,返回了错误的TaskScheduler给NacosWatch。至于哪一步返回错误的类,就要更深入的debug了。

2、debug获取TaskScheduler流程
(1)debug的入口,NacosWatch构造方法中taskScheduler赋值
package:com.alibaba.cloud.nacos.discovery
在这里插入图片描述
(2)ObjectProvider接口的getIfAvailable方法(default修饰)
package:org.springframework.beans.factory
在这里插入图片描述
(3)DefaultListableBeanFactory类的getIfAvailable方法
package:org.springframework.beans.factory.support
在这里插入图片描述
(4)DefaultListableBeanFactory类的doResolveDependency方法
package:org.springframework.beans.factory.support
在这里插入图片描述
其实看到findAutowireCandidates方法的autowire这个词,大概就能猜到是通过type去匹配实例了,不过还是点进去看看:

(5)BeanFactoryUtils类的beanNamesForTypeIncludingAncestors方法
package:org.springframework.beans.factory
注意:beanNamesForTypeIncludingAncestors是通过type查询beanName(注意beanName为defaultSockJsTaskScheduler),而非bean。获取实例是findAutowireCandidates方法处理的。
在这里插入图片描述
至于lbf.getBeanNamesForType方法,望文生义,懂的都懂。(这次文章就先不深究了,后续有空研究)
(6)看到这里,其实前因后果明白了七七八八,通过type获取bean,刚好spring容器里有一个匹配的上的bean,那么websocket肯定生成了bean并且交给spring管理(并且可以大胆猜测,bean是通过注解且方法名叫defaultSockJsTaskScheduler的方式托管给spring):
类:WebSocketConfigurationSupport
package:org.springframework.web.socket.config.annotation
在这里插入图片描述
如图所示,方法名叫defaultSockJsTaskScheduler,并且通过@Bean托管给spring。和图二.2.(5)刚好对应上!并且该方法在nacoswatch之前执行(说了句废话)。
(7)接二.2.(4),蓝框的正常流程。
getIfAvailable返回null
在这里插入图片描述
逻辑走到defaultSupplier.get(),注意defaultSupplier是个lambda表达式,debug继续走:
在这里插入图片描述
返回了正常的TaskScheduler接口的Bean。

3、问题原因
DefaultListableBeanFactory类通过classType获取实例,刚好websocket依赖有一个NoOpScheduler交给spring托管就匹配上返回了,导致NacosWatch获取错误的TaskScheduler。

三、解决方案:

1、通过@primary指定
在这里插入图片描述
2、关闭nacoswatch
spring.cloud.nacos.discovery.watch.enabled,设置为false

四、小插曲

(1)关于issues
本来以为发现一个nacos的小问题,然后"兴高采烈"的去nacos官方提issues了,没想到这个问题是属于SCA(Spring Cloud Alibaba)社区的,毕竟nacos-discovery的依赖全名是spring-cloud-starter-alibaba-nacos-discovery,这点没注意到,很尴尬。小伙伴们一定要注意这个问题,issues提到相应的社区,issues多了可能会影响维护人员的绩效考核。

这个是在SCA的issues:https://github.com/alibaba/spring-cloud-alibaba/issues/1952
官方说让我升级到2.2.4.RELEASE版本,这个问题在20-11-20解决了,更尴尬了…

(2)版本问题
在这里插入图片描述
官方说版本最好保持一致,官方说升级到nacos-discovery的2.2.4.RELEASE不知道和2.0.3的springboot会不会有兼容问题;还有就是nacos-discovery升级到2.2.4.RELEASE,项目的其他依赖也不知道是否需要升级版本…

萌新发言,不喜勿喷,欢迎大佬指出不当之处!

### 依赖 `spring-cloud-starter-alibaba-nacos-discovery` 的功能与用途 #### 1. **概述** `sprinng-cloud-starter-alibaba-nacos-discovery` 是 Spring Cloud Alibaba 提供的一个 Starter,用于简化微服务架构中基于 Nacos 的服务注册与发现过程。通过引入此依赖,开发者可以在 Spring Boot Spring Cloud 应用程序中轻松实现服务的自动化注册服务发现功能[^1]。 --- #### 2. **主要功能** ##### (1) **服务注册** 当应用程序启动时,`spring-cloud-starter-alibaba-nacos-discovery` 会自动将当前服务的信息(如服务名称、IP 地址端口号)注册到 Nacos 注册中心。这一过程完全透明化,开发者只需在配置文件中提供必要的参数即可完成注册操作[^2]。 以下是典型的配置示例: ```yaml spring: application: name: my-service # 服务名 cloud: nacos: discovery: server-addr: localhost:8848 # Nacos 服务器地址 ``` ##### (2) **服务发现** 除了服务注册外,该依赖还提供了强大的服务发现能力。通过内置的负载均衡器或其他工具,应用程序可以从 Nacos 获取其他服务的实例列表,并根据策略选择合适的实例发起请求。这种机制显著提升了系统的灵活性扩展性[^1]。 例如,在 Feign 客户端中可以通过简单的接口定义访问远程服务: ```java @FeignClient(name = "my-service") public interface MyServiceClient { @GetMapping("/api/resource") String getResource(); } ``` 此处的 `name = "my-service"` 即为注册到 Nacos 的服务名称,Spring Cloud 将负责解析具体的实例地址并建立连接。 --- #### 3. **与其他组件的关系** ##### (1) **与 OpenFeign 集成** 尽管 `spring-cloud-starter-alibaba-nacos-discovery` 主要关注于服务注册与发现,但它也可以很好地与其他 Spring Cloud 组件协同工作。比如,结合 `spring-cloud-starter-openfeign` 可以更高效地实现跨服务调用[^3]。 然而需要注意的是,如果项目同时引入这两个依赖却遇到了导入失败的情况,可能是因为缺少统一的版本管理所致。此时应按照标准方式添加 `<dependencyManagement>` 节点来解决冲突问题[^4]。 典型配置如下所示: ```xml <dependencyManagement> <dependencies> <!-- Spring Cloud 版本控制 --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-dependencies</artifactId> <version>2021.0.3</version> <type>pom</type> <scope>import</scope> </dependency> <!-- Spring Cloud Alibaba 版本控制 --> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-alibaba-dependencies</artifactId> <version>2021.0.4.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> ``` ##### (2) **与 Ribbon/LB 整合** 默认情况下,`spring-cloud-starter-alibaba-nacos-discovery` 已经集成了 Ribbon 或者 Spring Cloud LoadBalancer,因此无需额外安装任何插件就能享受开箱即用的负载均衡功能。 --- #### 4. **启用方式** 为了激活服务注册与发现功能,需在主类上标注 `@EnableDiscoveryClient` 注解。这一步骤告知 Spring Cloud 构建上下文时加载相应的 DiscoveryClient 实现类[^2]。 代码片段如下: ```java @SpringBootApplication @EnableDiscoveryClient public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` --- ### 总结 `sprinng-cloud-starter-alibaba-nacos-discovery` 是一款专注于服务治理领域的重要工具,其核心价值体现在以下几个方面: - 自动化的服务注册流程; - 基于 Nacos 的高可用服务发现机制; - 支持多种负载均衡算法以及灵活的扩展选项。 借助这些特性,开发团队可以更快捷地搭建起稳定可靠的分布式系统结构。 ---
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值