当前位置： 首页 > news >正文

25、《Spring Boot 3.0.0 集成 Nacos2.2 》

news 来源：原创 2025/6/9 2:52:32

Spring Boot 3.0.0 集成 Nacos 2.2

一、引言

在微服务架构中，服务注册与发现以及配置管理是至关重要的环节。Nacos 作为阿里巴巴开源的一站式服务发现、配置管理和服务管理平台，为微服务架构提供了强大的支持。Spring Boot 则是构建微服务应用的热门框架，其简洁的配置和快速开发的特性深受开发者喜爱。本文将详细介绍如何在 Spring Boot 3.0.0 项目中集成 Nacos，实现服务注册与发现以及配置管理功能。

二、环境准备

  1. JDK 环境：确保安装了 JDK 17 及以上版本，因为 Spring Boot 3.0.0 最低支持 JDK 17。可以通过命令java -version检查 JDK 版本。

  2. Maven 或 Gradle：项目构建工具，本文以 Maven 为例。确保 Maven 已正确安装并配置好环境变量，可通过mvn -v检查 Maven 版本。

  3. Nacos Server：下载并启动 Nacos Server。可以从 Nacos 官方 GitHub 仓库（https://github.com/alibaba/nacos/releases）下载对应版本的安装包。解压后，在conf目录下找到application.properties文件，配置好数据库等相关信息（如果需要持久化配置）。然后在bin目录下，根据操作系统执行startup.cmd（Windows）或startup.sh（Linux/Mac）启动 Nacos Server。启动成功后，可通过浏览器访问http://localhost:8848/nacos，使用默认账号nacos/nacos登录。

三、创建 Spring Boot 项目

  1. 使用 Spring Initializr：打开 Spring Initializr 官网（https://start.spring.io/），在页面中选择项目的相关信息，如项目类型为 Maven，语言为 Java，Spring Boot 版本为 3.0.0。在依赖项中添加 “Spring Web”、“Spring Cloud Starter Alibaba Nacos Discovery” 和 “Spring Cloud Starter Alibaba Nacos Config”。然后点击 “Generate” 按钮下载项目压缩包。

  2. 导入项目到 IDE：解压下载的项目压缩包，使用 IDE（如 IntelliJ IDEA 或 Eclipse）导入项目。导入完成后，等待 Maven 下载项目所需的依赖。

四、配置项目依赖

在项目的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>

    <groupId>com.example</groupId>
    <artifactId>spring-boot-nacos-config-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.0</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

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

    <dependencies>
        <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>2022.0.0.0</version>
        </dependency>
        <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>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>16</source>
                    <target>16</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

这里的spring-cloud-alibaba-dependencies版本需要根据 Spring Boot 3.0.0 的兼容性进行选择，确保依赖版本的一致性。

五、配置 Nacos 服务地址

在application.yml文件中配置 Nacos 服务的地址，包括服务注册与发现以及配置管理的地址：

spring:
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
      config:
        server-addr: 127.0.0.1:8848
        file-extension: yaml
        namespace: 38b17e55-128e-4f34-9c43-77a89ad1429f
  application:
    name: demo-springboot-nacos

在上述配置中，spring.application.name定义了应用的名称，这个名称将在 Nacos 中用于服务注册和配置管理。spring.cloud.nacos.discovery.server-addr指定了 Nacos 服务注册中心的地址，spring.cloud.nacos.config.server-addr指定了 Nacos 配置中心的地址，file-extension指定了配置文件的格式为 YAML。

六、启用服务注册与发现

在 Spring Boot 主应用类上添加@EnableDiscoveryClient注解，以启用服务注册与发现功能：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient
public class SpringBootNacosExampleApplication {

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

添加该注解后，Spring Boot 应用启动时会将自身注册到 Nacos 服务注册中心。

七、创建 REST 服务并测试服务注册

创建一个简单的 REST 控制器，用于测试服务注册与发现功能：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello, Nacos!";
    }
}

启动 Spring Boot 应用，然后登录 Nacos 控制台，在 “服务管理” -> “服务列表” 中可以看到名为spring-boot-nacos-example的服务已经注册成功。此时，通过浏览器访问http://localhost:8080/hello（假设应用启动在 8080 端口），可以看到返回的 “Hello, Nacos!” 信息，说明服务注册与发现功能正常。

八、使用 Nacos 配置管理

  1. 在 Nacos 控制台创建配置文件：在 Nacos 控制台的 “配置管理” -> “配置列表” 中，点击 “+” 号创建一个新的配置文件。Data ID 填写demo-springboot-nacos.yaml（与spring.application.name一致，加上.yaml后缀），配置组选择DEFAULT_GROUP（默认配置组），内容如下：
message: Hello from Nacos Config!
  1. 在 Spring Boot 项目中读取配置：创建一个配置类来读取 Nacos 配置：
import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RefreshScope
public class ConfigController {

    @Value("${message:Default Message}")
    private String message;

    @GetMapping("/config")
    public String getConfig() {
        return message;
    }
}

在上述代码中，@Value注解用于从配置文件中读取message属性的值，如果没有读取到则使用默认值 “Default Message”。@RefreshScope注解用于使配置能够动态刷新，即当 Nacos 中的配置文件更新时，应用能够自动获取最新的配置。

  1. 测试配置读取与动态刷新：启动 Spring Boot 应用，访问http://localhost:8080/config，可以看到返回的 “Hello from Nacos Config!” 信息，说明配置读取成功。然后在 Nacos 控制台修改spring-boot-nacos-example.yaml配置文件中的message属性值，保存后再次访问http://localhost:8080/config，可以看到返回的信息已经更新为修改后的内容，说明配置动态刷新功能正常。

九、总结

通过以上步骤，我们成功地在 Spring Boot 3.0.0 项目中集成了 Nacos，实现了服务注册与发现以及配置管理功能。Nacos 为微服务架构提供了可靠的服务治理和配置管理解决方案，而 Spring Boot 的简洁性和高效性使得集成过程变得相对简单。在实际项目中，可以根据需求进一步扩展和优化，例如使用 Nacos 的命名空间、配置分组等高级功能来更好地管理服务和配置。希望本文能够帮助读者快速上手 Spring Boot 与 Nacos 的集成，为构建高效的微服务架构打下基础。

十、附件

nacos2.2配置关键点：
在这里插入图片描述
1、springboot3.0 需要匹配springcloud2022.0.x，nacos需要2.2。
2、namespace和dataId要与代码中bootstap.yml中对应

相关文章：

  • 极坐标轴 极坐标的使用 极坐标坐标轴和刻度线
  • OpenDevin：开源AI软件工程师的通用代理平台
  • python从入门到精通（二十五）：文件操作和目录管理难度分级练习题
  • 登录校验会话技术
  • 01 微服务与 Spring Cloud 就是从“大杂烩”到“精密协作”的架构演进的必然结果
  • 数据结构：python实现最大堆算法
  • 联核科技AGV无人叉车的应用场景有哪些？
  • 3D数字化：家居行业转型升级的关键驱动力
  • 【电赛推荐芯片】差分放大器：INA143，仪表放大器：INA128 INA333 PGA204
  • 在WSL2-Ubuntu中安装CUDA12.8、cuDNN、Anaconda、Pytorch并验证安装
  • thrift软件、.thrif文件和thrift协议是什么关系，有什么用
  • TensorFlow.js 全面解析：在浏览器中构建机器学习应用
  • 无人机扩频技术对比！
  • 美团校招实习笔试历年真题与内推
  • Facebook 隐私保护技术的发展与未来趋势
  • 记录片《遇见大连》
  • 计算机毕业设计SpringBoot+Vue.js爱心捐赠项目推荐系统 慈善大数据(源码+文档+PPT+讲解)
  • 自然语言处理：高斯混合模型
  • AI编程工具-(六）
  • 【RAG 篇】万字长文：向量数据库选型指南 —— Milvus 与 FAISS/Pinecone/Weaviate 等工具深度对比
  • 烟台城乡建设住建局网站/关键词搜索趋势
  • 保险代理人做网站/中国新闻网
  • 建设银行网站注册/产品营销推广策略
  • 外贸网站怎样做推广/今日国际新闻事件
  • 漳州正规网站建设价格/长尾关键词挖掘爱站工具
  • 专业做二手房装修网站/网站模板购买