项目中引入 Nacos 配置中心

2021年12月12日 创建     

本篇手记将对在 SpringBoot 项目中引入 Nacos 配置中心做一个简单介绍。（本文不对 Nacos 的安装部署做介绍）

SpringBoot 版本：2.5.3

1. 加依赖

项目中引入 Spring Cloud 和 Spring Cloud Alibaba。（注意与 Spring Boot 的版本兼容性问题）

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2020.0.4</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>2021.1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

引入两个 starter，一个是引导配置文件的，一个是 Nacos 配置中心的。

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

2. 写配置

在 resources 目录下创建 bootstrap.yaml 配置文件，该配置文件会在项目启动时读取，用于引导程序到 Nacos 中读取相应配置。

基本的配置：

spring:
  application:
    name: persevere-server # 项目名称
  profiles:
    active: ${profiles.active} # 环境
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848  # 配置中心地址
        file-extension: yaml # nacos 中配置文件类型
        refresh-enabled: true # 允许热刷新

在项目启动时，程序会根据 项目名称-环境.配置文件的后缀 在 Nacos 中寻找配置，如本文中： persevere-server-dev.yaml。

项目配置完成后，下面是 Nacos 中添加配置。

3. Nacos 中创建配置文件

访问 Nacos 管理页面，在 配置管理->配置列表->右侧加号(+) 添加配置文件：

配置列表：

Nacos 配置文件创建好之后，就可以尝试在本地启动项目了。