🎓博主介绍：Java、Python、js全栈开发 “多面手”，精通多种编程语言和技术，痴迷于人工智能领域。秉持着对技术的热爱与执着，持续探索创新，愿在此分享交流和学习，与大家共进步。
📖DeepSeek-行业融合之万象视界(附实战案例详解100+)
📖全栈开发环境搭建运行攻略：多语言一站式指南(环境搭建+运行+调试+发布+保姆级详解)
👉感兴趣的可以先收藏起来，希望帮助更多的人
在这里插入图片描述

配置中心实战：SpringBoot+Nacos实现动态配置热更新

一、配置中心概述

1.1 什么是配置中心

配置中心是一种集中式管理应用配置的系统，它能够集中存储、管理和分发应用程序的配置信息。在分布式系统中，配置中心扮演着至关重要的角色，它可以解决传统配置管理方式存在的诸多问题，如配置分散、修改配置需要重启应用等。

1.2 为什么需要配置中心

在传统的应用开发和部署中，配置信息通常散落在各个应用的配置文件中。当应用数量增多、部署环境复杂时，这种方式会带来很多麻烦。例如，修改一个配置可能需要在多个地方进行操作，而且修改后往往需要重启应用才能生效，这会影响应用的可用性。

配置中心的出现解决了这些问题。它将所有配置集中管理，使得配置的修改更加便捷，并且能够实现配置的动态更新，即不需要重启应用就可以让新的配置生效，大大提高了系统的灵活性和可维护性。

1.3 Nacos简介

Nacos是阿里巴巴推出的一款开源的动态服务发现、配置管理和服务管理平台。它具有简单易用、高可用、高性能等特点，能够满足各种规模的分布式系统的配置管理需求。

Nacos支持多种配置格式，如Properties、YAML等，并且提供了友好的Web界面，方便用户进行配置的管理和操作。同时，Nacos还支持配置的版本控制、灰度发布等高级功能。

二、环境准备

2.1 安装JDK

Nacos和SpringBoot应用都需要运行在Java环境中，因此首先需要安装JDK。推荐安装JDK 8或以上版本。

安装步骤如下：

  1. 从Oracle官网或其他合法渠道下载JDK安装包。
  2. 运行安装包，按照提示完成安装。
  3. 配置环境变量，将JDK的bin目录添加到系统的PATH变量中。
  4. 打开命令行窗口，输入java -version命令，如果能够显示JDK的版本信息，则说明安装成功。

2.2 安装Nacos

2.2.1 下载Nacos

从Nacos的官方GitHub仓库（https://github.com/alibaba/nacos）下载最新的稳定版本的安装包。

2.2.2 解压安装包

将下载的安装包解压到指定的目录，例如D:\nacos。

2.2.3 启动Nacos
  • Windows系统：进入nacos\bin目录，双击startup.cmd文件启动Nacos。
  • Linux/Mac系统：进入nacos/bin目录，执行sh startup.sh -m standalone命令启动Nacos（ standalone表示单机模式）。

启动成功后，在浏览器中访问http://localhost:8848/nacos，可以看到Nacos的登录界面，默认用户名和密码都是nacos。

2.3 安装开发工具

推荐使用IntelliJ IDEA作为开发工具，它对SpringBoot项目有很好的支持。可以从JetBrains官网下载并安装。

三、创建SpringBoot项目

3.1 初始化项目

打开IntelliJ IDEA，选择Create New Project，然后选择Spring Initializr，按照提示填写项目信息，如Group、Artifact、Name等，选择合适的SpringBoot版本（推荐2.3.x及以上版本）。

3.2 添加依赖

在项目的pom.xml文件中添加以下依赖：

<!-- SpringBoot Web依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- Nacos配置中心依赖 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>2.2.5.RELEASE</version>
</dependency>

<!-- SpringCloud上下文依赖，用于配置刷新 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-context</artifactId>
    <version>2.2.5.RELEASE</version>
</dependency>

需要注意的是，SpringCloud Alibaba的版本需要与SpringBoot的版本相匹配，具体的版本对应关系可以参考官方文档。

3.3 配置项目基本信息

在src/main/resources目录下创建application.yml文件，配置项目的基本信息，如端口号等：

server:
  port: 8080

四、配置Nacos

4.1 登录Nacos控制台

在浏览器中访问http://localhost:8848/nacos，使用默认用户名和密码nacos登录。

4.2 创建配置

登录成功后，点击左侧菜单中的配置管理->配置列表，然后点击+按钮添加配置。

在添加配置页面，需要填写以下信息：

  • 数据ID：通常使用${spring.application.name}-${spring.profile.active}.${file-extension}的格式，例如nacos-demo-dev.yaml。其中，nacos-demo是应用名称，dev是环境，yaml是配置文件格式。
  • 分组：可以使用默认分组DEFAULT_GROUP，也可以根据需要自定义分组。
  • 配置格式：选择YAML。
  • 配置内容：填写具体的配置信息，例如：
user:
  name: zhangsan
  age: 20
  address: beijing

填写完成后，点击发布按钮保存配置。

五、SpringBoot集成Nacos

5.1 配置Nacos连接信息

在src/main/resources目录下创建bootstrap.yml文件（注意不是application.yml），配置Nacos的连接信息：

spring:
  application:
    name: nacos-demo
  cloud:
    nacos:
      config:
        server-addr: localhost:8848 # Nacos服务器地址
        file-extension: yaml # 配置文件格式
        group: DEFAULT_GROUP # 配置分组
  profiles:
    active: dev # 激活的环境

bootstrap.yml文件的加载优先级高于application.yml，它主要用于配置一些启动时需要的基本信息，如配置中心的地址等。

5.2 创建配置实体类

创建一个用于映射Nacos配置的实体类UserConfig：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "user")
@RefreshScope // 开启配置刷新功能
public class UserConfig {
    private String name;
    private Integer age;
    private String address;

    // getter和setter方法
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getAddress() {
        return address;
    }

    public void setAddress(String address) {
        this.address = address;
    }
}

@ConfigurationProperties(prefix = "user")注解用于将配置文件中以user为前缀的配置映射到该实体类的属性上。@RefreshScope注解用于开启配置的动态刷新功能，当Nacos中的配置发生变化时，该实体类的属性值会自动更新。

5.3 创建控制器

创建一个控制器UserController，用于测试配置的获取和动态更新：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @Autowired
    private UserConfig userConfig;

    @GetMapping("/user")
    public String getUserInfo() {
        return "姓名：" + userConfig.getName() + "，年龄：" + userConfig.getAge() + "，地址：" + userConfig.getAddress();
    }
}

该控制器通过@Autowired注解注入UserConfig实例，然后在getUserInfo方法中获取配置信息并返回。

5.4 创建启动类

创建SpringBoot应用的启动类NacosDemoApplication：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

六、测试动态配置热更新

6.1 启动应用

运行NacosDemoApplication类的main方法启动SpringBoot应用。

6.2 访问接口

在浏览器中访问http://localhost:8080/user，可以看到返回的配置信息：

姓名：zhangsan，年龄：20，地址：beijing

6.3 修改Nacos配置

登录Nacos控制台，找到之前创建的配置，将配置内容修改为：

user:
  name: lisi
  age: 25
  address: shanghai

然后点击发布按钮。

6.4 再次访问接口

不需要重启应用，再次在浏览器中访问http://localhost:8080/user，可以看到返回的配置信息已经更新：

姓名：lisi，年龄：25，地址：shanghai

这表明动态配置热更新功能已经实现。

七、高级功能

7.1 配置的版本控制

Nacos会自动对配置进行版本控制，每次修改配置后，都会生成一个新的版本。在Nacos控制台的配置详情页面，可以查看配置的历史版本，并且可以回滚到之前的版本。

7.2 配置的灰度发布

Nacos支持配置的灰度发布，即可以将新的配置先发布到部分应用实例上，验证无误后再全量发布。实现灰度发布需要在配置中设置spring.cloud.nacos.config.namespace和spring.cloud.nacos.config.group等参数，具体可以参考Nacos的官方文档。

7.3 配置的监听

除了使用@RefreshScope注解实现配置的自动更新外，还可以通过编程的方式监听配置的变化。例如，可以使用NacosConfigManager来添加配置监听器：

import com.alibaba.cloud.nacos.NacosConfigManager;
import com.alibaba.nacos.api.config.listener.Listener;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

import javax.annotation.PostConstruct;
import java.util.concurrent.Executor;

@Component
public class NacosConfigListener {

    @Autowired
    private NacosConfigManager nacosConfigManager;

    @PostConstruct
    public void init() throws Exception {
        String dataId = "nacos-demo-dev.yaml";
        String group = "DEFAULT_GROUP";
        nacosConfigManager.getConfigService().addListener(dataId, group, new Listener() {
            @Override
            public void receiveConfigInfo(String configInfo) {
                System.out.println("配置发生变化：" + configInfo);
                // 在这里可以处理配置变化后的逻辑
            }

            @Override
            public Executor getExecutor() {
                return null;
            }
        });
    }
}

当配置发生变化时，receiveConfigInfo方法会被调用，我们可以在该方法中处理配置变化后的逻辑。

八、总结

本文详细介绍了如何使用SpringBoot和Nacos实现动态配置热更新。首先介绍了配置中心的概念和Nacos的基本情况，然后讲解了环境准备、项目创建、Nacos配置、SpringBoot集成Nacos等步骤，最后测试了动态配置热更新功能，并介绍了Nacos的一些高级功能。

通过使用Nacos作为配置中心，我们可以实现配置的集中管理和动态更新，提高系统的灵活性和可维护性。在实际项目中，还可以根据需要使用Nacos的其他功能，如服务发现等，以构建更加完善的分布式系统。

# spring boot # 后端 # java
Logo
乐奇 Rokid 开放社区

更多推荐

cover

国庆文旅安保上新！AR智能眼镜守护景区，黑科技护航假期出游

avatar 乐奇 Rokid 开放社区
cover

2027中国深圳智能穿戴产业链展览会

avatar 乐奇 Rokid 开放社区
cover

化工行业AR巡检找哪家公司比较好

avatar 乐奇 Rokid 开放社区