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

在Java项目中使用Nacos作为配置中心,可以实现配置的集中管理与动态刷新,避免硬编码和重启应用更新配置的问题。以下是基于Spring Boot整合Nacos配置中心的完整流程。
引入依赖
在Spring Boot项目中使用Nacos做配置中心,需要添加Nacos Config Starter依赖。如果你使用Maven,添加以下内容到pom.xml:
com.alibaba.cloud spring-cloud-starter-alibaba-nacos-config 2022.0.0.0
确保同时引入了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),在“配置管理”中新建配置:
-
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 {
@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
}
注意事项
- Nacos服务需提前启动,确保网络可达。
-
bootstrap.yml必须存在且正确配置,否则无法连接配置中心。 - 动态刷新依赖Spring Cloud Context模块,确保版本兼容。
- 生产环境建议配置命名空间(namespace)和分组(group)进行环境隔离。
基本上就这些。通过以上步骤,Java应用即可接入Nacos配置中心,实现配置统一管理和热更新。











