###
Spring Boot 整合 Nacos 配置中心 示例教程
#### 1
. 添加 Maven 依赖
为了使
Spring Boot 项目能够与
Nacos 进行交互，需要引入 `
spring-cloud-starter-alibaba-
nacos-config` 和其他必要的依赖。
```xml
<dependency>
<groupId>com
.alibaba
.cloud</groupId>
<artifactId>
spring-cloud-starter-alibaba-
nacos-config</artifactId>
<version>
20
21
.1</version>
</dependency>
<!-- 如果还需要使用
Nacos 的服务发现功能 -->
<dependency>
<groupId>com
.alibaba
.cloud</groupId>
<artifactId>
spring-cloud-starter-alibaba-
nacos-discovery</artifactId>
<version>
20
21
.1</version>
</dependency>
```
以上依赖版本应根据实际使用的
Spring Cloud 版本进行调整[^1]。
---
####
2. 创建
Bootstrap 文件并配置连接参数
在
Spring Boot 中，`
bootstrap
.yml` 或 `
bootstrap
.properties` 是用于加载早期配置的文件。它会先于 `application
.yml` 被加载，因此适合放置
Nacos 配置中心的相关参数。
以下是典型的 `
bootstrap
.yml` 配置：
```yaml
spring:
application:
name: demo-service # 应用名称
cloud:
nacos:
config:
server-addr: localhost:8848 #
Nacos服务器地址
file-extension: yaml # 配置文件格式，默认为properties
shared-configs: # 共享配置
- data-id: common-config
.yaml
refresh: true # 开启动态刷新
discovery:
server-addr: localhost:8848 # 可选：如果需要服务注册与发现
```
通过上述配置，
Spring Boot 将会在启动时自动从指定的
Nacos 地址获取对应的配置数据[^
2]。
---
#### 3
. 启动类添加注解
为了让
Spring Boot 自动感知到
Nacos 并完成配置同步，需在项目的主启动类上添加特定注解。
```java
import org
.springframework
.boot.SpringApplication;
import org
.springframework
.boot.autoconfigure
.SpringBootApplication;
import com
.alibaba
.cloud
.nacos.NacosDiscoveryProperties;
@
SpringBootApplication
@
NacosPropertySource(dataId = "demo-service", autoRefreshed = true) // 动态刷新支持
public class DemoApplication {
public static void main(String[] args) {
SpringApplication
.run(DemoApplication
.class, args);
}
}
```
此部分代码确保了应用能够在运行期间实时监听来自
Nacos 的配置变化，并触发相应的更新逻辑[^3]。
---
#### 4
. 测试动态刷新机制
假设我们在
Nacos 控制台创建了一个名为 `common-config
.yaml` 的配置文件，其中定义了一些全局变量：
```yaml
app
.name: My Application
logging
.level
.root: DEBUG
```
随后可以在业务代码中注入这些属性值：
```java
import org
.springframework
.beans
.factory
.annotation
.Value;
import org
.springframework
.web
.bind
.annotation
.GetMapping;
import org
.springframework
.web
.bind
.annotation
.RestController;
@RestController
public class ConfigController {
@Value("${app
.name}")
private String appName;
@GetMapping("/config")
public String getConfig() {
return "App Name: " + appName;
}
}
```
访问 `/config` 接口即可验证配置是否生效。修改
Nacos 上的内容后无需重启服务即能立即看到最新效果[^
2]。
---
#### 5
. 处理高级场景——共享配置
对于多个微服务共用的部分配置（如 Redis 参数），可以通过 `shared-configs` 来实现统一管理。例如：
```yaml
spring:
cloud:
nacos:
config:
shared-configs:
- data-id: redis-config
.yaml
group: DEFAULT_GROUP
refresh: true
```
这样所有的服务都可以继承该公共配置而不需要重复声明。
---
#### 总结
通过上述步骤，可以顺利完成
Spring Boot 与
Nacos 配置中心的
整合工作。整个过程涉及到了 Maven 依赖导入、
Bootstrap 文件编写以及动态刷新的支持等多个方面[^4]。
---
本文详细介绍了如何将SpringBoot应用与Nacos配置中心进行整合，包括添加依赖、配置properties、启动类设置以及通过Postman进行测试。通过Nacos实现配置的集中管理和动态刷新，简化了项目的配置管理。
最低0.47元/天 解锁文章
扫一扫
5436
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
