在 springboot 中如何使用 nacos 做配置中心

在 springboot 中如何使用 nacos 做配置中心

首页/常见问题/低代码开发/在 springboot 中如何使用 nacos 做配置中心

作者：低代码发布时间：2025-05-13 18:01浏览量：4079

织信企业级低代码开发平台

提供表单、流程、仪表盘、API等功能，非IT用户可通过设计表单来收集数据，设计流程来进行业务协作，使用仪表盘来进行数据分析与展示，IT用户可通过API集成第三方系统平台数据。

免费试用

在Spring Boot中使用Nacos做配置中心非常直观：首先、引入Nacos Config Starter依赖；其次、在配置文件bootstrap.properties中配置Nacos服务器地址和应用名；第三、通过@Value或@ConfigurationProperties注解读取配置；第四、配置动态刷新以使配置更改立即生效。具体而言，首先要确保项目已加入Nacos Config Starter依赖，在Maven中通常是通过添加对应的<dependency>来做到这一点。其提供了必要的自动化配置项，让Spring Boot应用能够从Nacos配置中心拉取和更新配置。

一、引入Nacos Config Starter依赖

首先，在Spring Boot项目的pom.xml中加入Nacos Config Starter的依赖：

<dependencies>
    <!-- ... 其他依赖 ... -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    </dependency>
</dependencies>

通过该依赖，Spring Boot应用将能够连接Nacos服务器并获取配置信息。

二、配置Nacos服务器地址和应用名

接下来，在bootstrap.properties文件中添加Nacos服务器的地址以及应用要使用的Data ID和Group：

spring.application.name=my-springboot-app
spring.cloud.nacos.config.server-addr=127.0.0.1:8848
spring.cloud.nacos.config.namespace=
spring.cloud.nacos.config.group=DEFAULT_GROUP
spring.cloud.nacos.config.extension-configs[0].data-id=custom.properties
spring.cloud.nacos.config.extension-configs[0].refresh=true

在这里，spring.application.name定义了应用名，spring.cloud.nacos.config.server-addr指定了Nacos服务器的地址，其他参数则是对Nacos配置中心更细致的配置。

三、读取配置

在Spring Boot应用中，可以使用@Value注解直接绑定配置文件中的值到类的字段上：

@Component
public class AppConfig {
    @Value("${some.config}")
    private String someConfig;
    // ... 其他字段和方法 ...
}

另外，可以使用@ConfigurationProperties批量绑定配置到一个POJO上：

@ConfigurationProperties(prefix = "my.config")
@Component
public class MyConfig {
    private String property1;
    private int property2;
    // ... getters and setters ...
}

这样就可以在项目中通过依赖注入的方式使用配置信息。

四、配置动态刷新

为了在配置发生变更时应用能够自动刷新配置，需要在类上添加@RefreshScope注解：

@Component
@RefreshScope
public class DynamicConfig {
    @Value("${dynamic.config}")
    private String dynamicConfig;
    // ... 其他字段和方法 ...
}

添加了此注解后，一旦从Nacos配置中心更新了dynamic.config的值，Spring Boot应用会自动更新dynamicConfig字段的内容。

五、整合多环境配置

在实际开发中，通常会有多个环境（如开发、测试、生产），Nacos支持通过profiles来区分环境：

spring.profiles.active=dev
spring.cloud.nacos.config.file-extension=properties
spring.cloud.nacos.config.shared-configs[0].data-id=common-${spring.profiles.active}.properties
spring.cloud.nacos.config.shared-configs[0].refresh=true

在Nacos中可以为不同的环境维护不同的配置，通过激活不同的profiles来加载对应的配置。

六、处理配置更新事件

可以监听Nacos配置更新事件，执行自定义逻辑：

@Component
public class ConfigChangeListener {
    @Value("${some.value}")
    private String someValue;
    @EventListener
    public void onConfigChanged(ConfigChangeEvent event) {
        if (event.getChangeItems().stream().anyMatch(change -> "some.value".equals(change.getPropertyName()))) {
            // 配置更新后的逻辑处理
            // 如更新缓存、通知其他服务等
        }
    }
}

这种方式可以进一步扩展配置变更处理的逻辑。

七、安全性和加密

对于敏感配置，可以在Nacos中使用加密数据的方式存储，并且配合Spring Cloud的加解密机制确保安全性。例如，使用Jasypt进行属性加密，并在启动时传递密钥或通过其他安全方式获取：

<dependency>
    <groupId>com.github.ulisesbocchio</groupId>
    <artifactId>jasypt-spring-boot-starter</artifactId>
</dependency>

在配置文件中使用加密值，并在启用应用时指定解密密钥，从而确保敏感信息的安全。

八、总结

通过Nacos作为配置中心，在Spring Boot项目中集成非常容易且高效。它不仅能够帮助集中管理应用配置，还支持配置的动态刷新和环境区分，极大提高了配置管理的灵活性和开发效率。对于大型系统和微服务架构，利用Nacos做配置中心可以说是一种行之有效的配置管理方案。

作为一家全球知名的超大型企业，吉利需要大量的技术人员来满足各事业部门的日常数字化需求。在内部强调“降本增效”的大环境下，吉利通过采购“织信低代码平台”，开发周期平均缩短61%，人力投入减少47%，解决了开发需求常年堆积的难题。

医院后勤服务领军者——某管家

国内市场化运作、跨区域经营、集团化管理的大型专业医疗机构后勤服务供应商，全国80多座城市，每天为超过百万的病人和医护人员提供服务，通过织信低代码平台构建线上数字化的方式服务各医院的后勤保障和正常运行，主要为运送条线、保洁条线、秩序条线、工程条线、医废条线等解决工单调度、医辅材料运输、多端协同的效率难题。

中国兵器工业集团——银光化学

国家“一五”期间156个重点项目之一。属于国家高新技术企业，在信息化升级建设中，存在大量“小、散、碎”的信息化需求，需要投入大量人力资源进行开发，通过引入织信低代码平台，解决当下遇到的各类业务难题，提升整体的IT研发效率。

石油领域重点工程单位——川庆钻探

随着国企工规模的不断扩大和内部数字化转型的要求不断提升，公司着眼长远，决定借助织信低代码的各方面能力，从物资储备管理入手，并辐射经营、生产、工程、日常管理等多个板块，为后续内部信息化建设打好基座。

汽车零部件上市企业——川环科技

川环为了有效应对残酷的市场现实，高层一致决定加强公司内部管理，8大部门将全面进行数字化转型，耗时10月，成功上线8套系统，通过织信低代码平台对接现有用友U9ERP，实现各部门的业务线上化，并通过数据治理，实现整个企业从战略到经营管理的分析。

B2C跨境电商知名品牌——朗驰实业

全球500强车企巨头——吉利集团