Spring Boot单体项目整合Nacos

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

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

整合

(1)pom.xml

创建一个 Spring Boot 项目,pom.xml 如下:

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 如下:

yaml 复制代码
server:
  port: 8080

spring:
  application:
    name: nacos-demo
  config:
    import:
      - nacos:nacos-demo.yml?group=demo&namespace=nacos-demo
  cloud:
    nacos:
      config:
        enabled: true
        namespace: nacos-demo
        server-addr: localhost:8848
        file-extension: yml
        group: demo
        import-check:
          enabled: false

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

(3)云端创建配置

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

使用

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

java 复制代码
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;

    @Override
    public String demo() {
        return name;
    }
}

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

启动项目,调用接口

修改 nacos 配置值

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

控制台有打印日志

总结

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

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

配置文件如下:

yml 复制代码
spring:
  application:
    name: nacos-demo
  cloud:
    nacos:
      discovery:
        namespace: nacos-demo
        server-addr: localhost:8848
        group: demo
相关推荐
一枚小小程序员哈3 小时前
基于微信小程序的诊所信息系统的设计与实现
spring boot·struts·spring·spring cloud·java-ee·maven·intellij-idea
Juchecar4 小时前
解决Windows下根目录运行 pnpm dev “无法启动 Vite 前端,只能启动 Express 后端”
前端·后端·node.js
奕川4 小时前
Colima + nerdctl 零基础教程:告别 Docker Desktop,拥抱轻量容器世界
后端
dylan_QAQ4 小时前
Java转Go全过程01-基础语法部分
java·后端·go
Ka1Yan4 小时前
[算法] 双指针:本质是“分治思维“——从基础原理到实战的深度解析
java·开发语言·数据结构·算法·面试
追逐时光者4 小时前
C#/.NET/.NET Core技术前沿周刊 | 第 52 期(2025年8.25-8.31)
后端·.net
轮子大叔4 小时前
Spark学习记录
java·spark
一语长情5 小时前
RocketMQ 消息队列冷读问题的分析与优化
java·后端·架构