###
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>2021.1</version>
</dependency>
<!-- 如果还需要使用
Nacos 的服务发现功能 -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>
spring-cloud-starter-alibaba-
nacos-discovery</artifactId>
<version>2021.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]。
---
最低0.47元/天 解锁文章
扫一扫
1588
到【灌水乐园】发言
