Spring Boot 3.0.0 集成 Nacos 2.2
一、引言
在微服务架构中，服务注册与发现以及配置管理是至关重要的环节。Nacos 作为阿里巴巴开源的一站式服务发现、配置管理和服务管理平台，为微服务架构提供了强大的支持。Spring Boot 则是构建微服务应用的热门框架，其简洁的配置和快速开发的特性深受开发者喜爱。本文将详细介绍如何在 Spring Boot 3.0.0 项目中集成 Nacos，实现服务注册与发现以及配置管理功能。
二、环境准备
-
JDK 环境：确保安装了 JDK 17 及以上版本，因为 Spring Boot 3.0.0 最低支持 JDK 17。可以通过命令java -version检查 JDK 版本。
-
Maven 或 Gradle：项目构建工具，本文以 Maven 为例。确保 Maven 已正确安装并配置好环境变量，可通过mvn -v检查 Maven 版本。
-
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 项目
-
使用 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” 按钮下载项目压缩包。
-
导入项目到 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 配置管理
- 在 Nacos 控制台创建配置文件：在 Nacos 控制台的 “配置管理” -> “配置列表” 中，点击 “+” 号创建一个新的配置文件。Data ID 填写demo-springboot-nacos.yaml（与spring.application.name一致，加上.yaml后缀），配置组选择DEFAULT_GROUP（默认配置组），内容如下：
message: Hello from Nacos Config!
- 在 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 中的配置文件更新时，应用能够自动获取最新的配置。
- 测试配置读取与动态刷新：启动 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中对应
扫一扫
5364
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
