SpringBoot集成Nacos_springboot nacos

1. 概述

Nacos是一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。Spring Boot是一个用于创建独立、生产级别的基于Spring的应用的框架。集成Nacos到SpringBoot中，可以方便地实现服务发现、配置管理和动态配置刷新等功能。
在集成之前，确保你已经安装了Nacos服务器，并且它正在运行。你可以在Nacos的官方GitHub仓库中找到安装和配置Nacos服务器的指南。

2. 添加依赖

在你的SpringBoot项目的pom.xml文件中，添加Nacos的依赖。这里以Maven为例：

<dependencies>  
    <!-- Spring Cloud Alibaba Nacos Config Starter -->  
    <dependency>  
        <groupId>com.alibaba.cloud</groupId>  
        <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>  
        <version>你的版本</version>  
    </dependency>  
      
    <!-- Spring Cloud Alibaba Nacos Discovery Starter -->  
    <dependency>  
        <groupId>com.alibaba.cloud</groupId>  
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>  
        <version>你的版本</version>  
    </dependency>  
      
    <!-- 其他依赖 -->  
</dependencies>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

请确保你使用的是与你的SpringBoot版本兼容的Spring Cloud Alibaba版本。

3. 配置Nacos

在bootstrap.properties或bootstrap.yml文件中配置Nacos的相关信息。bootstrap配置文件在SpringBoot应用中会优先于application配置文件加载。

spring:  
  cloud:  
    nacos:  
      config:  
        server-addr: 127.0.0.1:8848 # Nacos服务器地址  
        namespace: your-namespace-id # 命名空间ID（可选）  
        group: DEFAULT_GROUP # 配置分组（可选）  
        data-id: your-data-id # 数据ID，用于区分不同的配置文件  
        file-extension: yaml # 配置文件格式，默认为properties  
        extension-configs[0]:  
          data-id: example.yaml # 额外的配置文件  
          group: EXTRA_GROUP  
          refresh: true # 是否支持动态刷新  
        shared-configs[0]:  
          data-id: shared-common.yaml # 共享的配置文件  
          group: COMMON_GROUP  
          refresh: true  
      discovery:  
        server-addr: 127.0.0.1:8848 # Nacos服务器地址，与服务配置共享  
        namespace: your-namespace-id # 命名空间ID（可选），与服务配置共享
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

4. 使用Nacos配置

在你的SpringBoot应用中，你可以通过@Value注解或

@ConfigurationProperties来注入Nacos中的配置。
@Component  
@ConfigurationProperties(prefix = "your.config.prefix")  
public class YourConfigProperties {  
    private String someProperty;  
      
    // getter and setter  
}
1
2
3
4
5
6
7
8

在application.yml中，你可以通过占位符${…}来引用Nacos中的配置。

5. 启用服务发现

在你的SpringBoot应用的启动类上添加@EnableDiscoveryClient注解来启用服务发现功能。

@SpringBootApplication  
@EnableDiscoveryClient  
public class YourApplication {  
    public static void main(String[] args) {  
        SpringApplication.run(YourApplication.class, args);  
    }  
}
1
2
3
4
5
6
7

6. 动态配置刷新

如果你希望能够在Nacos中修改配置后，无需重启应用即可使配置生效，你可以使用Spring Cloud Context的@RefreshScope注解。

@Component  
@RefreshScope  
public class YourRefreshableComponent {  
    // ...  
}
1
2
3
4
5

修改Nacos中的配置后，发送POST请求到/actuator/refresh端点（如果启用了Spring Boot Actuator）来刷新配置。

7. 测试与验证

启动你的SpringBoot应用，并检查Nacos控制台以确保应用已成功注册。同时，验证应用是否能够正确读取Nacos中的配置信息，并且当配置发生变化时能够动态刷新。

注意事项
确保Nacos服务器的地址、端口、命名空间和分组等信息配置正确。
如果你的应用需要多个配置文件，可以使用extension-configs和shared-configs来配置额外的和共享的配置文件。
如果你的应用需要连接到Nacos集群，可以在server-addr中配置多个Nacos节点的地址，使用逗号分隔。
如果你的应用需要连接到Nacos的命名空间，请确保配置了正确的命名空间ID。
注意版本兼容性，确保你使用的Spring Cloud Alibaba版本与你的SpringBoot版本兼容。