Spring Boot单体项目整合Nacos

说明：nacos 不一定只能用于微服务架构，单体架构也能使用 Nacos 作为项目云端配置中心，利用 nacos 配置热更新的功能，存储一些需要实时更新的配置。

本文介绍单体项目如何整合 nacos，使用 nacos 的配置中心。

整合

（1）pom.xml

创建一个 Spring Boot 项目，pom.xml 如下：

<?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><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.3.13</version><relativePath/></parent><groupId>com.hezy</groupId><artifactId>nacos_demo</artifactId><version>1.0-SNAPSHOT</version><properties><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties><dependencies><!-- Web依赖 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- 配置依赖 --><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId><version>2023.0.3.3</version></dependency></dependencies>
</project>

注意 Spring Boot 和 nacos 的版本，有兼容问题

（2）application.yml

application.yml 如下：

server:port: 8080spring:application:name: nacos-democonfig:import:- nacos:nacos-demo.yml?group=demo&namespace=nacos-democloud:nacos:config:enabled: truenamespace: nacos-demoserver-addr: localhost:8848file-extension: ymlgroup: demoimport-check:enabled: false

最后的 import-check: enabled=false 是启动时配置校验，=true 时发现在 nacos 上找不到该服务的配置启动会报错。

（3）云端创建配置

在 nacos 控制台，对应 namespace 下对应的 group 下创建一个配置，配置名（data id）要与项目中配置的服务名与设置的扩展名（yml）一致，如下：

使用

在代码的 Service 层，读取某个配置项

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.stereotype.Service;@RefreshScope
@Service
public class DemoServiceImpl implements DemoService {@Value("${demo.name}")private String name;@Overridepublic String demo() {return name;}
}

注意类上要加 @RefreshScope 注解，该注解可热更新配置。nacos 配置的内容如下：

启动项目，调用接口

修改 nacos 配置值

再次调用接口，读取的是修改后的配置

控制台有打印日志

总结

本文介绍了单体项目使用 Nacos 作为云端配置中心使用，作为注册中心，则引入下面这个依赖

        <!-- 注册依赖 --><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId><version>2023.0.3.3</version></dependency>

配置文件如下：

spring:application:name: nacos-democloud:nacos:discovery:namespace: nacos-demoserver-addr: localhost:8848group: demo