java怎么使用Nacos做配置中心利用Nacos实现配置管理与动态刷新-java教程-PHP中文网

java怎么使用Nacos做配置中心利用Nacos实现配置管理与动态刷新

小老鼠

发布： 2025-12-01 16:27:06

原创

144人浏览过

首先引入Nacos Config Starter依赖并配置bootstrap.yml连接Nacos，再在控制台添加对应Data ID的配置，最后通过@Value或@ConfigurationProperties结合@RefreshScope实现配置动态刷新。

java怎么使用nacos做配置中心利用nacos实现配置管理与动态刷新

在Java项目中使用Nacos作为配置中心，可以实现配置的集中管理与动态刷新，避免硬编码和重启应用更新配置的问题。以下是基于Spring Boot整合Nacos配置中心的完整流程。

引入依赖

在Spring Boot项目中使用Nacos做配置中心，需要添加Nacos Config Starter依赖。如果你使用Maven，添加以下内容到pom.xml：

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>2022.0.0.0</version> <!-- 根据Spring Boot版本选择合适的版本 -->
</dependency>

登录后复制

确保同时引入了Spring Cloud Alibaba的依赖管理，例如通过spring-cloud-alibaba-dependencies统一版本控制。

配置Nacos连接信息

在bootstrap.yml（不是application.yml）中配置Nacos服务器地址和相关元数据：

立即学习“Java免费学习笔记（深入）”；

spring:
  application:
    name: demo-service
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848  # Nacos服务地址
        file-extension: yaml          # 配置文件格式，支持 properties 或 yaml
        namespace: dev                # 可选：命名空间ID
        group: DEFAULT_GROUP          # 可选：分组，默认DEFAULT_GROUP

登录后复制

注意：bootstrap.yml优先于application.yml加载，用于初始化配置中心连接。

在Nacos控制台添加配置

登录Nacos控制台（默认地址 http://127.0.0.1:8848），在“配置管理”中新建配置：

Word-As-Image for Semantic Typography

文字变形艺术字、文字变形象形字

查看详情

Data ID：一般为${spring.application.name}.${file-extension}，如demo-service.yaml
Group：与配置中的group一致，默认DEFAULT_GROUP
配置内容：填写YAML或Properties格式的配置项，例如：

app:
  title: "Hello Nacos"
  version: "1.0"

登录后复制

在Java代码中读取配置并支持动态刷新

使用@Value或@ConfigurationProperties注入配置，并结合@RefreshScope实现动态刷新。

示例代码：

@RestController
@RefreshScope
public class ConfigController {
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">@Value("${app.title}")
private String title;

@GetMapping("/title")
public String getTitle() {
    return this.title;
}

登录后复制

}

当Nacos中的配置被修改并发布后，调用该接口将返回最新值，无需重启服务。

若使用配置类方式：

@Component
@RefreshScope
@ConfigurationProperties(prefix = "app")
public class AppProperties {
    private String title;
    private String version;
    // getter and setter
}

登录后复制