Nacos系列【24】集成Nacos 2.x配置中心及动态刷新配置

梦里梦外; 2024-04-08 08:49 97阅读 0赞

有道无术,术尚可求,有术无道,止于术。

文章目录

    • 前言
    • 集成Nacos 2.x配置中心
        1. 环境搭建
        1. 解决Param ‘serviceName’ is illegal, serviceName is blank
        1. 读取远程配置
    • 动态刷新配置
      • 方式1:@RefreshScope
      • 方式2: @NacosValue

前言

在很早之前我们使用Nacos 1.3.2搭建了配置中心,自从发布2.0版本以来,以及Spring Boot 、Cloud持续发布,升级到Nacos2.x发现了一些升级需要注意的问题,所以写这篇文档闭坑,顺便讲解下如何实现动态刷新配置。

集成Nacos 2.x配置中心

首先按照之前的文档安装Nacos 2.x 以及升级到最新客户端。

Nacos系列(15)-Nacos2.0.3安装

1. 环境搭建

添加配置中心依赖:

  1. <dependency>
  2. <groupId>com.alibaba.cloud</groupId>
  3. <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
  4. </dependency>

添加bootstrap.yml文件,该文件会在应用启动时最先加载,并在文件中添加配置中心:

  1. server:
  2. port: 9005
  3. spring:
  4. application:
  5. name: app-service001
  6. cloud:
  7. nacos:
  8. discovery:
  9. server-addr: 127.0.0.1:8848
  10. config:
  11. server-addr: 127.0.0.1:8848
  12. file-extension: yaml
  13. enabled: true

Nacos控制台,添加一个app-service001.yaml配置文件,内容如下:
在这里插入图片描述

2. 解决Param ‘serviceName’ is illegal, serviceName is blank

首先启动的时候,控制台打印了以下错误信息:

  1. java.lang.IllegalArgumentException: Param 'serviceName' is illegal, serviceName is blank
  2. at com.alibaba.nacos.api.naming.utils.NamingUtils.getGroupedName(NamingUtils.java:47) ~[nacos-client-2.1.0.jar:na]
  3. at com.alibaba.nacos.client.naming.event.InstancesChangeNotifier.registerListener(InstancesChangeNotifier.java:55) ~[nacos-client-2.1.0.jar:na]
  4. at com.alibaba.nacos.client.naming.NacosNamingService.subscribe(NacosNamingService.java:392) ~[nacos-client-2.1.0.jar:na]
  5. at com.alibaba.cloud.nacos.discovery.NacosWatch.start(NacosWatch.java:134) ~[spring-cloud-starter-alibaba-nacos-discovery-2.2.8.RELEASE.jar:2.2.8.RELEASE]
  6. at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:178) [spring-context-5.3.8.jar:5.3.8]
  7. at org.springframework.context.support.DefaultLifecycleProcessor.access$200(DefaultLifecycleProcessor.java:54) [spring-context-5.3.8.jar:5.3.8]
  8. at org.springframework.context.support.DefaultLifecycleProcessor$LifecycleGroup.start(DefaultLifecycleProcessor.java:356) [spring-context-5.3.8.jar:5.3.8]
  9. at java.lang.Iterable.forEach(Iterable.java:75) ~[na:1.8.0_201]
  10. at org.springframework.context.support.DefaultLifecycleProcessor.startBeans(DefaultLifecycleProcessor.java:155) [spring-context-5.3.8.jar:5.3.8]
  11. at org.springframework.context.support.DefaultLifecycleProcessor.onRefresh(DefaultLifecycleProcessor.java:123) [spring-context-5.3.8.jar:5.3.8]
  12. at org.springframework.context.support.AbstractApplicationContext.finishRefresh(AbstractApplicationContext.java:935) ~[spring-context-5.3.8.jar:5.3.8]
  13. at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:586) ~[spring-context-5.3.8.jar:5.3.8]

大概意思就是没有配置服务名,也就是没有配置spring.application.name,而我们明明是在bootstrap.yml中添加了的:
在这里插入图片描述
而且在启动开始,并没有打印连接到配置中心的日志:
在这里插入图片描述
由此猜想,难道是bootstrap.yml没有被加载?

首先要知道bootstrap.yml优先于application.yml加载,其目的是为了在应用启动时,加载一些系统级的资源配置项,比如远程配置中心地址,该文件是由引导上下文在启动最开始的阶段去加载的。

而该机制是spring-cloud-starter-bootstrap 提供的,Spring Boot 默认是不支持,在Spring Boot 2.4之后的版本,提供了spring.config.import通过属性导入配置数据的方法,所以Spring Cloud也就移除了spring-cloud-starter-bootstrap ,改用spring.config.import作为默认集成配置中心的方式。官网说明

在Spring Cloud Alibaba 2021.0.1.0 升级指南中,也对此进行了详细说明。
在这里插入图片描述

所以怎么解决这个问题呢?

  • 方案1:自己引入spring-cloud-starter-bootstrap
  • 方案2:使用 spring.config.import方式引入配置

既然都Spring Cloud 都推荐使用 spring.config.import,那么我们就用这个吧~

首先删除bootstrap.yml,在application.yml使用import 的方式导入Nacos 的配置:

  1. spring:
  2. application:
  3. name: app-service001
  4. cloud:
  5. nacos:
  6. config:
  7. group: DEFAULT_GROUP
  8. server-addr: 127.0.0.1:8848
  9. config:
  10. import:
  11. #- optional:nacos:test.yml # 监听 DEFAULT_GROUP:test.yml
  12. #- optional:nacos:test01.yml?group=group_01 # 覆盖默认 group,监听 group_01:test01.yml
  13. #- optional:nacos:test02.yml?group=group_02&refreshEnabled=false # 不开启动态刷新
  14. - nacos:app-service001.yaml # 在拉取nacos配置异常时会快速失败,会导致 spring 容器启动失败

启动程序,可以看到连接到了Nacos 远程配置中心:
在这里插入图片描述

3. 读取远程配置

首先写一个测试配置类,通过@Value读取配置:

  1. @Configuration
  2. public class Person {
  3. @Value("${person.name}")
  4. String name;
  5. @Value("${person.age}")
  6. Integer age;
  7. // getter setter

在写一个测试访问接口,返回配置内容:

  1. @Autowired
  2. Person person;
  3. @GetMapping("/test")
  4. public String test() {
  5. return person.toString();
  6. }

访问接口,可以看到读取到了Nacos 中的配置:
在这里插入图片描述
接着修改以下配置内容,再次访问,发现并没有返回更新后的数据,所以这就牵扯出配置动态刷新的问题。
在这里插入图片描述

动态刷新配置

方式1:@RefreshScope

@RefreshScope是Spring Cloud 提供的注解,可以看到它就是通过Spring 的作用域来实现的。
在这里插入图片描述
在之前的配置类上添加注解:

  1. @Configuration
  2. @RefreshScope
  3. public class Person {
  4. }

重新启动应用,修改Nacos 中的配置,再通过接口查看数据,可以看到是最新修改后的数据~~

方式2: @NacosValue

@NacosValue在看到这个注解的时候,去看了源码,上面注释写的是Annotation which extends value to support auto-refresh.,说它是@Value注解的扩展,并支持动态刷新。

然后直接在上面的测试案例中使用@NacosValue,发现连配置中心的配置都获取不到,更不用说动态刷新了。

  1. @NacosValue(value = "${person.name}", autoRefreshed = true)
  2. String name;

接着咨询了一下开发大佬:
在这里插入图片描述
又在官网中发现了相关说明:
在这里插入图片描述
由上总结@NacosValueSpring Cloud并不能直接使用,只是为了在纯Spring环境中方便集成配置中心,Spring Cloud环境下使用其本身推荐的方式。

要想使用@NacosValue需要添加以下依赖:

  1. <dependency>
  2. <groupId>com.alibaba.nacos</groupId>
  3. <artifactId>nacos-spring-context</artifactId>
  4. <version>1.1.1</version>
  5. </dependency>

然后在启动类或者配置类上添加@EnableNacosConfig@NacosPropertySource注解:

  1. @EnableNacosConfig(globalProperties = @NacosProperties(serverAddr = "127.0.0.1:8848"))
  2. @NacosPropertySource(dataId = "app-service001.yaml", autoRefreshed = true)

使用@NacosConfigurationProperties获取配置:

  1. @NacosConfigurationProperties(prefix = "person",
  2. dataId = "app-service001.yaml",
  3. autoRefreshed = true,
  4. type = ConfigType.YAML
  5. )
  6. @Data
  7. @Component
  8. public class NacosValueConfig {
  9. private String name;
  10. private Integer age;
  11. }

或者@NacosValue获取配置:

  1. @NacosValue(value = "${person.name}", autoRefreshed = true)
  2. String name;
  3. @GetMapping("/value")
  4. public String value() {
  5. System.out.println(nacosValueConfig.toString());
  6. System.out.println(person.toString());
  7. System.out.println(name);
  8. return "@NacosConfigurationProperties ";
  9. }

启动项目,访问获取配置接口:
在这里插入图片描述
修改配置,再次访问,可以看到打印了配置刷新的日志,并且获取到了最新配置:
在这里插入图片描述
当然方式2 并不推荐使用

发表评论

表情:
评论列表 (有 0 条评论,97人围观)

还没有评论,来说两句吧...

相关阅读