脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → SpringCloud alibaba使用Nacos配置中心

SpringCloud alibaba使用Nacos配置中心解读

 更新时间：2026年01月17日 08:55:45   作者：没事儿写两篇  
本文介绍了如何在Spring Boot项目中使用Spring Cloud Alibaba和Nacos进行依赖管理、配置管理及配置刷新,通过添加BOM和配置文件,可以简化依赖版本的管理,并实现配置的动态刷新,同时,还展示了如何通过自定义DataId进行配置管理,并详细介绍了各种配置方式的优先级

依赖管理

Spring Cloud Alibaba BOM 包含了它所使用的所有依赖的版本

请将下面的 BOM 添加到 pom.xml 中的 部分。 这将允许我们省略任何Maven依赖项的版本，而是将版本控制委派给BOM。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>${spring.cloud.alibaba.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

引用时，请注意版本对应关系。比如我们的示例版本为：2021.0.4.0。其与Spring Boot以及Spring Cloud的版本对应关系如下(为避免不必要的依赖冲突，请按照如下版本对应关系验证本文示例)

Spring Cloud Alibaba VersionSpring Cloud VersionSpring Boot Version
2021.0.4.0*Spring Cloud 2021.0.42.6.11

目前最新版本是2022.x，支持Spring Boot 3.0，我们知道Spring Boot 3.0.x需要使用java 17，针对国内大多数应用来说，目前还是java8，所以本文还是选用java8支持的版本。

更多的版本对应关系请参考官网：Spring Cloud Alibaba maven依赖版本对应关系

完整pom依赖配置

一个完整的Spring Cloud Alibaba的pom.xml依赖如下

dependencies标签中的依赖根据自己实际情况引入即可。此处只是Nacos的使用示例

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>CloudDemo</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <build.name>CloudDemo</build.name>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>

        <spring.cloud.version>2021.0.4</spring.cloud.version>
        <spring.cloud.alibaba.version>2021.0.4.0</spring.cloud.alibaba.version>
    </properties>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.11</version>
    </parent>

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

    <dependencies>

        <!-- 使用Nacos服务注册与发现 -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>

        <!-- 使用Nacos配置管理 -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>

        <!-- 支持读取bootstrap配置 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-bootstrap</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- 添加web依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

    </dependencies>
</project>

添加bootstrap.properties配置

# 引用pom文件中配置的profile（注意名称的对应）
spring.profiles.active=@profileActive@
# 应用名称
spring.application.name=myCloud
# Nacos配置
spring.cloud.nacos.config.server-addr=127.0.0.1:8848
# 配置的group（默认DEFAULT_GROUP）
spring.cloud.nacos.config.group=DEFAULT_GROUP
# 配置后缀默认是properties（只支持properties和ymal）
spring.cloud.nacos.config.file-extension=properties
# 是否开启自动刷新配置（默认true）
spring.cloud.nacos.config.refresh-enabled=true

注意当你使用域名的方式来访问 Nacos 时，spring.cloud.nacos.config.server-addr 配置的方式为 域名:port。

例如 Nacos 的域名为abc.com.nacos，监听的端口为 80，则 spring.cloud.nacos.config.server-addr=abc.com.nacos:80。 注意 80 端口不能省略。

在 Nacos Spring Cloud 中，dataId 的完整格式如${prefix}-${spring.profiles.active}.${file-extension}

  • prefix 默认为 spring.application.name 的值，也可以通过配置项 spring.cloud.nacos.config.prefix来配置。
  • spring.profiles.active 即为当前环境对应的 profile，详情可以参考 Spring Boot文档。 注意：当 spring.profiles.active 为空时，对应的连接符 - 也将不存在，dataId 的拼接格式变成 ${prefix}.${file-extension}
  • file-exetension 为配置内容的数据格式，可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。目前只支持 properties 和 yaml 类型。

注：Nacos Config相关的配置必须放在 bootstrap.properties 配置文件中，放在application.properties中自动刷新配置不会生效。

一般情况下，我们的应用，应该需要配置profile，而且要应用Spring Boot和Maven的profile组合配置。所以，我们的pom文件丰富一下

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>CloudDemo</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <build.name>CloudDemo</build.name>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>

        <spring.cloud.version>2021.0.4</spring.cloud.version>
        <spring.cloud.alibaba.version>2021.0.4.0</spring.cloud.alibaba.version>
    </properties>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.11</version>
    </parent>

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

    <dependencies>

        <!-- 使用Nacos服务注册与发现 -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>

        <!-- 使用Nacos配置管理 -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>

        <!-- 支持读取bootstrap配置 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-bootstrap</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- 添加web依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

    </dependencies>


    <profiles>
        <profile>
            <id>dev</id>
            <properties>
                <profileActive>dev</profileActive>
            </properties>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
        </profile>
        <profile>
            <id>test</id>
            <properties>
                <profileActive>test</profileActive>
            </properties>
        </profile>
        <profile>
            <id>pre</id>
            <properties>
                <profileActive>pre</profileActive>
            </properties>
        </profile>
        <profile>
            <id>prod</id>
            <properties>
                <profileActive>prod</profileActive>
            </properties>
        </profile>
    </profiles>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>

        <finalName>${build.name}</finalName>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <filtering>true</filtering>
                <includes>
                    <include>mapper/**/*.xml</include>
                    <include>application.properties</include>
                    <include>application-${profileActive}.properties</include>
                    <include>bootstrap.properties</include>
                    <include>logback-spring.xml</include>
                </includes>
            </resource>
        </resources>
    </build>

</project>

application.properties配置

# 当前应用的访问端口
server.port=8701
# 当前应用的访问上下文
server.servlet.context-path=/myCloud

编写启动类

package com.yyoo.cloud;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication(scanBasePackages = {"com.yyoo"})
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

}

本示例的启动类和普通的Spring Boot项目启动类没什么两样.

编写测试Controller

package com.yyoo.cloud.controller;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("conf")
@RefreshScope
public class TestConfController {

    @Value("${name:默认值}")
    private String name;

    @RequestMapping("getName")
    public String getName(){
        System.out.println(this.name);
        return this.name;
    }

}

@RefreshScope是Spring Cloud 的原生注解，用于实现配置自动更新。

在Nacos界面上添加对应的配置

启动应用并访问

启动后访问 http://localhost:8701/myCloud/conf/getName

界面显示结果：没事儿写两篇

在界面修改配置 name=没事儿写两篇2 ，再次访问链接

界面显示结果：没事儿写两篇2

自定义扩展的 Data Id 配置

我们上面的示例，配置的dataId是通过特定的规则来自动匹配的，这样很方便，但是也限制的很死。我们的同样的应用部署在不同的服务器，可能只是些许配置不一样，怎样能共用一样的配置呢？上面的方式显然是不行的。

Spring Cloud Alibaba Nacos Config 从 0.2.1 版本后，可支持自定义 Data Id 的配置。

使用spring.cloud.nacos.config.extension-configs配置

# 自定义扩展dataId ，extension-configs是个列表，意味着可以配置多个
# 必须带文件扩展名，文件扩展名既可支持 properties，又可以支持 yaml/yml。
# 此时 spring.cloud.nacos.config.file-extension 的配置对自定义扩展配置的 Data Id 文件扩展名没有影响。
spring.cloud.nacos.config.extension-configs[0].data-id=myCloud-common1.yml
# 配置的group，默认DEFAULT_GROUP
spring.cloud.nacos.config.extension-configs[0].group=COMMON_GROUP
# 是否自动刷新（注意：这里默认是false，如果需要自动刷新，必须配置为true）
spring.cloud.nacos.config.extension-configs[0].refresh=true

注意以上配置也是在bootstrap.properties中配置

在Nacos中新增配置

使用ConfigurationProperties来接收

package com.yyoo.cloud.conf;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;

@Data
@Configuration
@ConfigurationProperties("my.mycloud")
public class CommonConf {

    private String name;

    private int age;

    private String desc;

}

我们这里没有添加@RefreshScope注解，因为我们使用spring.cloud.nacos.config.extension-configs[0].refresh=true配置了，所以配置是会自动刷新的。

TestController读取配置

    @Resource
    private CommonConf conf;
    
    @RequestMapping("getCommonConf")
    public String getCommonConf() throws JsonProcessingException {
        System.out.println(conf);
        return this.conf.toString();
    }

访问链接后输出结果：CommonConf(name=没事儿写两篇, age=12, desc=Spring Cloud 学习)

注意：TestController中的CommonConf 是被代理之后的对象，包含很多内容，建议不要用json进行转换打印。

spring.cloud.nacos.config.shared-configs配置

spring.cloud.nacos.config.shared-configs[0].data-id=myCloud-common1.yml
spring.cloud.nacos.config.shared-configs[0].group=COMMON_GROUP
spring.cloud.nacos.config.shared-configs[0].refresh=true

其用法和extension-configs一样。其主要作用是为了更加清晰的在多个应用间配置共享的 Data Id。

各种配置方式的优先级

  • A: 通过 spring.cloud.nacos.config.shared-configs[n].data-id 支持多个共享 Data Id 的配置
  • B: 通过 spring.cloud.nacos.config.extension-configs[n].data-id 的方式支持多个扩展 Data Id 的配置
  • C: 通过内部相关规则(应用名、应用名+ Profile )自动生成相关的 Data Id 配置

当三种方式共同使用时，他们的一个优先级关系是:A < B < C

总结

我们实际项目当中可能涉及到要在Nacos中添加很多配置，这些配置如何区分，如何定位？

Nacos的概念中，dataId、group、namespace是主要的区分和定位作用。本文示例中没有使用namespace，其实如果我们命名规则定义的好，只通过dataId和group也能精准定位。根据自身的需要制定合理的规则即可。

spring.cloud.nacos.config.namespace用于指定namespace，在没有明确指定 ${spring.cloud.nacos.config.namespace} 配置的情况下， 默认使用的是 Nacos 上 Public 这个namespace

通过设置 spring.cloud.nacos.config.enabled = false 可以完全关闭 Spring Cloud Nacos Config

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

相关文章

  • Java爬虫(Jsoup与WebDriver)的使用

    Java爬虫(Jsoup与WebDriver)的使用

    这篇文章主要介绍了Java爬虫(Jsoup与WebDriver)的使用,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2020-12-12
  • 解决Java中SimpleDateFormat线程不安全的五种方案

    解决Java中SimpleDateFormat线程不安全的五种方案

    SimpleDateFormat 就是一个典型的线程不安全事例，本文主要介绍了解决Java中SimpleDateFormat线程不安全的五种方案，需要的朋友们下面随着小编来一起学习学习吧
    2021-05-05
  • 聊聊SpringMVC项目依赖和静态资源导出问题

    聊聊SpringMVC项目依赖和静态资源导出问题

    这篇文章主要介绍了SpringMVC项目依赖和静态资源导出问题,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
    2021-12-12
  • intellij idea 启动tomcat 1099端口被占用的解决

    intellij idea 启动tomcat 1099端口被占用的解决

    这篇文章主要介绍了intellij idea 启动tomcat 1099端口被占用的解决，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2019-09-09
  • Java基于ip2region.xdb数据库从IP获取到属地解析的全攻略

    Java基于ip2region.xdb数据库从IP获取到属地解析的全攻略

    在日常的Java开发中,IP地址相关的操作是非常常见的需求,无论是用户行为分析、地域化服务,还是安全防护,都需要精准地获取和解析IP信息,本文将详细介绍一个功能完善的Java IP工具类,需要的朋友可以参考下
    2026-02-02
  • Java String字符串和Unicode字符相互转换代码详解

    Java String字符串和Unicode字符相互转换代码详解

    这篇文章主要介绍了Java String字符串和Unicode字符相互转换代码，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2019-05-05
  • jbuilder2006连接sqlserver2000的方法

    jbuilder2006连接sqlserver2000的方法

    xp jbuiler2006 连接SQL SERVER2000的问题
    2008-10-10
  • 详解IDEA搭建springBoot方式一(推荐)

    详解IDEA搭建springBoot方式一(推荐)

    这篇文章主要介绍了IDEA搭建springBoot方式一(推荐),本文通过图文并茂的形式给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
    2020-10-10
  • java spring validation 自动、手动校验

    java spring validation 自动、手动校验

    HibernateValidator简化了Java开发中的参数校验过程,提供自动和手动两种校验方式,通过引入相关依赖并使用@Validated注解,可以实现自动校验,手动校验则需要使用ValidatorUtils类,此方法有效减少代码重复,提高开发效率
    2024-09-09
  • 详解Java虚拟机(JVM)运行时

    详解Java虚拟机(JVM)运行时

    JVM（Java虚拟机）是一个抽象的计算模型。这篇文章主要介绍了Java虚拟机(JVM)运行时的相关知识,需要的朋友可以参考下
    2018-10-10

最新评论