<think>
我们正在讨论
Nacos配置中心的使用
步骤。根据引用[2]和引用[4]，我们可以总结出以下
步骤：
1. **添加依赖**：在项目的pom.xml中添加
Spring Cloud Alibaba
Nacos Config的依赖。
2. **创建
bootstrap配置文件**：因为
配置中心的信息需要在应用启动时加载，所以必须使用
bootstrap.properties或
bootstrap.yaml（或
bootstrap.yml）来配置
Nacos Server的地址等信息。
3. **配置
Nacos服务器信息**：在
bootstrap配置文件中配置
Nacos服务器的地址（server-addr）、命名空间（namespace，可以是命名空间ID）、分组（group，默认为DEFAULT_GROUP）以及用户名密码（如果需要认证）等。
4. **指定配置文件格式**：如果配置文件是yml格式，需要特别指定file-extension为yml（引用[4]提到）。
5. **在
Nacos控制台创建配置**：在
Nacos控制台上创建配置文件，注意Data Id的命名规则，通常与应用的名称有关（默认是${
spring.application.name}.${file-extension}，也可以自定义）。
6. **应用中使用配置**：在应用中可以通过@Value注解获取配置，并且结合@RefreshScope实现动态刷新。
7. **配置的动态更新**：当在
Nacos控制台修改配置后，应用会自动获取最新配置（需要@RefreshScope）。
下面我将详细描述每一步：
### 一、添加依赖
在Maven项目的pom.xml中添加以下依赖：
```xml
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>
spring-cloud-starter-alibaba-
nacos-config</artifactId>
<version>${latest.version}</version>
</dependency>
```
注意：版本要与
Spring Boot版本对应。
### 二、创建
bootstrap配置文件
在resources目录下创建`
bootstrap.yml`（或
bootstrap.properties）文件。这是因为
Spring Boot应用在启动时会先加载
bootstrap配置，然后再加载application配置。
### 三、配置
Nacos服务器信息
在`
bootstrap.yml`中配置
Nacos服务器信息，例如：
```yaml
spring:
application:
name: example-service # 应用名，用于构成Data Id
cloud:
nacos:
config:
server-addr: 192.168.xxx.xxx:8848 #
Nacos服务器地址
username:
nacos # 如果
Nacos有认证
password:
nacos
namespace: b4d0832b-a7b0-44c2-8ce5-1abe676a4736 # 命名空间ID，非必填
group: DEFAULT_GROUP # 分组，默认DEFAULT_GROUP，非必填
file-extension: yml # 配置文件扩展名，如果是yml则必须指定，默认properties
```
### 四、在
Nacos控制台创建配置
1. 登录
Nacos控制台（地址为server-addr指定的地址）。
2. 在配置管理->配置列表中，点击“+”创建配置。
3. 填写Data Id：默认规则为`${
spring.application.name}.${file-extension}`，例如上面应用名为`example-service`，文件扩展名为`yml`，则Data Id为`example-service.yml`。
4. 选择配置格式（YAML或Properties等）。
5. 填写配置内容（例如：`server.port: 8080`）。
6. 点击发布。
### 五、应用中使用配置
在
Spring管理的Bean中，可以通过`@Value`注解注入配置值。例如：
```java
@RestController
@RefreshScope // 支持动态刷新
public class ConfigController {
@Value("${server.port}")
private String port;
@GetMapping("/port")
public String getPort() {
return port;
}
}
```
### 六、配置动态更新
修改
Nacos控制台上的配置并发布后，应用会监听到配置变化并自动更新带有`@RefreshScope`的Bean中的配置值。
### 七、多配置加载
如果需要加载多个配置文件，可以使用`shared-configs`或`extension-configs`。例如：
```yaml
spring:
cloud:
nacos:
config:
shared-configs:
- data-id: common.yml
group: DEFAULT_GROUP
refresh: true # 是否动态刷新，默认false
extension-configs:
- data-id: example-service-ext.yml
group: DEFAULT_GROUP
refresh: true
```
### 注意事项
- **配置优先级**：`extension-configs` > `shared-configs`（按数组顺序，后加载的覆盖先加载的）> 主配置（即应用名对应的配置）。
- **命名空间和分组**：用于环境隔离和业务隔离。
- **配置格式**：支持Properties、YAML、TEXT、JSON、XML等。
通过以上
步骤，即可在
Spring Boot应用中集成
Nacos配置中心。
§§相关问题§§
1. 如何在
Spring Boot项目中同时使用
Nacos注册中心和
配置中心？
2.
Nacos配置中心的配置优先级规则是怎样的？
3. 如何实现
Nacos配置的多环境切换（如dev、test、prod）？
4.
Nacos配置中心如何实现配置回滚？
5. 如何在
Nacos配置中心中管理敏感信息（如密码）？
</think>
###
Nacos 配置中心使用
步骤详解
结合引用内容[1][2][3][4]，完整使用流程如下：
####
步骤 1：添加依赖
在 Maven 项目中引入核心依赖：
```xml
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>
spring-cloud-starter-alibaba-
nacos-config</artifactId>
<version>2022.0.0.0</version> <!-- 适配
Spring Boot 3.x -->
</dependency>
```
####
步骤 2：创建 `
bootstrap.yml` 配置文件（**关键
步骤**）
必须使用 `
bootstrap.yml` 初始化连接[^2][^4]：
```yaml
spring:
application:
name: order-service # 服务名（决定配置Data ID）
cloud:
nacos:
config:
server-addr: 192.168.1.100:8848 #
Nacos服务器地址
username:
nacos # 登录账号
password:
nacos # 登录密码
namespace: dev-env # 环境隔离标识
group: ORDER_GROUP # 业务分组
file-extension: yaml # 配置文件格式[^4]
refresh-enabled: true # 启用动态刷新
```
####
步骤 3：在
Nacos 控制台创建配置
1. 登录
Nacos 控制台（`http://192.168.1.100:8848/
nacos`）
2. 选择对应 `namespace` 和 `group`
3. 新建配置（Data ID 规则：`${
spring.application.name}.${file-extension}`）
```bash
# 示例：order-service.yaml
server:
port: 8080
database:
url: jdbc:mysql://db-prod:3306/order
```
####
步骤 4：代码中使用配置
通过 `@Value` 注入配置，并添加动态刷新支持[^1][^4]：
```java
@RestController
@RefreshScope // 启用配置热更新
public class PaymentController {
@Value("${database.url}")
private String dbUrl; // 自动注入配置值
@GetMapping("/info")
public String getConfig() {
return "当前数据库地址：" + dbUrl;
}
}
```
####
步骤 5：验证动态刷新
1. 在
Nacos 控制台修改 `database.url` 值
2. 观察日志：客户端自动接收更新通知
```log
Received config change: dataId=order-service.yaml
```
3. 访问 `/info` 接口将返回新配置值（无需重启服务）
---
### 关键配置解析
| **配置项** | **作用** | **示例值** |
|-------------------|------------------------------------------------------------------------|------------------------|
| `server-addr` |
Nacos 服务器地址 | `192.168.1.100:8848` |
| `file-extension` | 配置文件后缀(**必须与控制台Data ID一致**)[^4] | `yaml` / `properties` |
| `namespace` | 环境隔离(开发/测试/生产) | `dev-env` |
| `group` | 业务分组(不同微服务组) | `ORDER_GROUP` |
| `shared-configs` | 加载公共配置(如数据库通用配置)[^3] | `data-id: common-db.yaml` |
---
### 最佳实践建议
1. **配置分层**
- 基础配置：`shared-configs`（数据库、Redis等公共配置）
- 环境配置：`namespace`隔离不同环境
- 业务配置：`group`隔离不同业务线
2. **安全加固**
```yaml
spring:
cloud:
nacos:
config:
# 加密敏感配置
encrypted-data-keys: database.password
```
3. **配置回滚机制**
-
Nacos 自动保存配置历史版本
- 通过控制台可一键回滚到任意版本[^3]
---
扫一扫
1023
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
