室内设计培训机构排行_宁波网络seo推广_杭州数据推广_免费创建网站软件

更多SpringBoot3内容请关注我的专栏：《SpringBoot3》
期待您的点赞??收藏评论

重学SpringBoot3-如何整合Nacos V2.3.2

• 1. Nacos 简介与功能
• • 版本说明
• 2. Spring Boot 3.2.x 与 Nacos 2.3.2 整合的步骤
• • 2.1 运行Nacos服务
  • 2.2 添加依赖
  • 2.3 配置 Nacos 连接
  • 2.4 配置 Nacos 注册与发现
  • 2.5 配置 Nacos 动态配置功能
• 3. 常见问题与解决方法
• • 3.1 连接 Nacos 失败
  • 3.2 服务未能成功注册到 Nacos
  • 3.3 服务注册成功，配置拿不到
  • 3.4 No spring.config.import property has been defined
• 4. 总结

随着微服务架构的广泛应用，服务注册与发现的需求变得越来越重要。Nacos（Dynamic Naming and Configuration Service 首字母）作为一个开源的、动态的服务发现与配置管理平台，已成为许多开发者的首选工具。Spring Boot 与 Nacos 的整合能够帮助开发者快速实现服务注册、配置管理以及动态控制等功能。

本文将详细介绍如何将 Spring Boot 3.2.x 和 Nacos 2.3.2 进行整合，包括功能介绍、版本依赖、整合过程中的细节及效果演示。

1. Nacos 简介与功能

Nacos 是一个易于使用的、支持多种服务发现和配置管理的开源项目。它提供了如下核心功能：

• 服务发现与健康检查：支持通过 HTTP、DNS 和 gRPC 协议进行服务注册与发现，同时可以对注册的服务进行健康检查。
• 动态配置管理：提供配置管理功能，允许开发者在不重启服务的情况下修改应用配置，并实时生效。
• 动态 DNS 服务：支持通过 DNS 查询服务实例的地址，实现更加灵活的服务发现。
• 分布式配置管理：能够为不同的环境、应用提供差异化的配置管理。

版本说明

Nacos 1.x 已经停止功能维护，请尽快升级到 2.x 版本。并且 Nacos 版本依赖 SpringBoot、Spring Cloud 的版本，对于刚刚升级到 springboot3 的小伙伴来说，会遇到很多莫名其妙的问题，大多数都是由于版本依赖造成的问题，建议直接到官网找推荐的版本组合，springcloud alibaba与springboot版本对应。

亲测 SpringBoot 3.2.x + Nacos 2.3.2 + SpringCloud 2023.0.1.0 组合可用，下面介绍也将基于此版本组合讲解。

2. Spring Boot 3.2.x 与 Nacos 2.3.2 整合的步骤

2.1 运行Nacos服务

多种运行方式见官网：https://nacos.io/docs/latest/quickstart/quick-start/，本地直接使用docker安装即可运行。

Nacos 2.x 除了 8848 端口以为还需要占用以下端口，如果云服务器部署需要放行端口号。

兼容性说明见：https://nacos.io/docs/v2/upgrading/version2-compatibility/

运行nacos服务后，还需设置密码，创建命名空间，新建配置等。

2.2 添加依赖

首先，你需要在 Spring Boot 项目中添加 Nacos 的相关依赖。Nacos 提供了一个官方的 Spring Cloud Alibaba 依赖包来支持 Spring Boot 项目的集成。

修改 pom.xml 文件，添加如下依赖：

<dependencies><!-- Spring Boot Web依赖 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- Spring Boot与Nacos整合的核心依赖 --><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId><version>2023.0.1.0</version> <!-- 与Spring Boot 3.2.x兼容 --></dependency><!-- 配置管理依赖，如果你需要配置管理功能 --><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId><version>2023.0.1.0</version></dependency><!--提供了引导配置的支持，允许应用程序在启动时从外部配置中心（如 Nacos、Consul、Config Server 等）加载配置。--><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-bootstrap</artifactId><version>4.1.4</version></dependency>
</dependencies>

注意：这里的 spring-cloud-starter-alibaba-nacos-discovery 和 spring-cloud-starter-alibaba-nacos-config 是 Spring Cloud Alibaba 相关的 starter。2023.0.1.0 版本与 Spring Boot 3.2.x 兼容。

2.3 配置 Nacos 连接

在 bootstrap.properties 或 bootstrap.yml 文件中，配置 Nacos 服务的连接信息。配置如下：

为什么要bootstrap.yml？用在应用程序启动的早期阶段，通过 bootstrap.yml 或 bootstrap.properties 文件加载配置，这些配置可以在主应用配置之前生效。spring-cloud-starter-bootstrap 提供了引导配置的支持。

spring:application:name: spring-boot3-14-nacosprofiles:active: local # 切换环境cloud:nacos:config:server-addr: 1.94.x.x:8848namespace: c77472dd-768c-42b0-8755-b6d87af491cf # 填命名空间idfile-extension: yamlgroup: DEFAULT_GROUPrefresh-enabled: true# 如果开启认证的话需要用户名和密码username: nacosupassword: nacosudiscovery:server-addr: 1.94.26.81:8848namespace: c77472dd-768c-42b0-8755-b6d87af491cf# 如果开启认证的话需要用户名和密码username: nacosupassword: nacosu

配置项说明

更多关于 spring-cloud-starter-alibaba-nacos-config 的 starter 配置项如下所示：

配置项

key

默认值

说明

服务端地址

spring.cloud.nacos.config.server-addr

服务器 ip 和端口

DataId 前缀

spring.cloud.nacos.config.prefix

${spring.application.name}

DataId 的前缀，默认值为应用名称

Group

spring.cloud.nacos.config.group

DEFAULT_GROUP

分组

DataId 后缀及内容文件格式

spring.cloud.nacos.config.file-extension

properties

DataId 的后缀，同时也是配置内容的文件格式，目前只支持 properties、yaml

配置内容的编码方式

spring.cloud.nacos.config.encode

UTF-8

配置的编码

获取配置的超时时间

spring.cloud.nacos.config.timeout

3000

单位为 ms

配置的命名空间

spring.cloud.nacos.config.namespace

常用场景之一是不同环境的配置的区分隔离，例如开发测试环境和生产环境的资源隔离等。

AccessKey

spring.cloud.nacos.config.access-key

SecretKey

spring.cloud.nacos.config.secret-key

相对路径

spring.cloud.nacos.config.context-path

服务端 API 的相对路径

接入点

spring.cloud.nacos.config.endpoint

地域的某个服务的入口域名，通过此域名可以动态地拿到服务端地址

是否开启监听和自动刷新

spring.cloud.nacos.config.refresh-enabled

true

集群服务名

spring.cloud.nacos.config.cluster-name

推荐方式

由于配置写到配置文件中，不便于修改不同环境的参数，且容易泄露敏感信息，一般建议如下写法：

spring:application:name: spring-boot3-14-nacosprofiles:active: ${PROFILE}cloud:nacos:discovery:server-addr: ${DISCOVERY_SVC}namespace: ${NAMESPACE_ID}username: ${NACOS_USER}password: ${NACOS_PWD}config:server-addr: ${DISCOVERY_SVC}namespace: ${NAMESPACE_ID}group: ${GROUP}file-extension: yamlusername: ${NACOS_USER}password: ${NACOS_PWD}

启动时使用命令行参数给配置赋值：

--spring.application.json={"PROFILE":"dev","DISCOVERY_SVC":"1.94.x.x:8848","NAMESPACE":"demo","GROUP":"DEFAULT_GROUP","NAMESPACE_ID":"c77472dd-768c-42b0-8755-b6d87af491cf","NACOS_USER":"nacosu","NACOS_PWD":"nacosu"}

2.4 配置 Nacos 注册与发现

在 @SpringBootApplication 或其他配置类上添加 @EnableDiscoveryClient 启用 Nacos 服务发现功能：

@SpringBootApplication
@EnableDiscoveryClient
public class NacosProviderApplication {public static void main(String[] args) {SpringApplication.run(NacosProviderApplication.class, args);}@RestControllerclass EchoController {@RequestMapping(value = "/echo/{string}", method = RequestMethod.GET)public String echo(@PathVariable String string) {return "Hello Nacos Discovery " + string;}}
}

2.5 配置 Nacos 动态配置功能

如果你想使用 Nacos 的配置管理功能，可以在应用中添加配置类， Spring Cloud 原生注解 @RefreshScope 实现配置自动更新：

代码示例

@RestController
@RequestMapping("/config")
@RefreshScope
public class ConfigController {@Value("${useLocalCache:false}")private boolean useLocalCache;@RequestMapping("/get")public boolean get() {return useLocalCache;}
}

效果

3. 常见问题与解决方法

3.1 连接 Nacos 失败

如果 Spring Boot 应用无法连接 Nacos 服务，可能是以下原因：

• 检查 spring.cloud.nacos.discovery.server-addr 配置项的地址是否正确。
• 确保 Nacos 服务端口未被防火墙或其他网络配置阻塞，8848、9848、9845。
• 配置文件未使用 bootstrap.yml 或者 bootstrap.properties 。

3.2 服务未能成功注册到 Nacos

• 确认 @EnableDiscoveryClient 注解是否正确添加到启动类。
• 确认 spring.application.name 配置项是否设置为应用名称。
• 检查 Nacos 控制台中是否存在其他错误信息。

3.3 服务注册成功，配置拿不到

首先排除掉版本兼容问题，其他可能原因：

• namespace 配置项错误填入了 namesapce 名称，应该填 namespaceId。
• dataId 的完整格式 ${prefix}-${spring.profiles.active}.${file-extension}，当 spring.profiles.active 为空时，对应的连接符 - 也将不存在，dataId 的拼接格式变成 ${prefix}.${file-extension}

3.4 No spring.config.import property has been defined

产生问题的原因是 bootstrap.yml 比 application.properties 的优先级要高。由于 bootstrap.yml 是系统级的资源配置文件，是用在程序引导执行时更加早期配置信息读取；但是在SpringCloud 2020.* 以后版本把 bootstrap 禁用了，导致在读取文件的时候读取不到而报错，所以我们只要把 bootstrap 从新导入进来就会生效了。

        <!--提供了引导配置的支持，允许应用程序在启动时从外部配置中心（如 Nacos、Consul、Config Server 等）加载配置。--><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-bootstrap</artifactId><version>4.1.4</version></dependency>

4. 总结

本文介绍了如何在 Spring Boot 3.2.x 项目中整合 Nacos 2.3.2，包括依赖配置、Nacos 服务发现与动态配置的配置方法。通过整合 Nacos，Spring Boot 应用可以实现高效的服务发现、动态配置管理以及分布式系统中的灵活扩展。希望通过本篇博客，您能顺利完成 Spring Boot 与 Nacos 的整合，并提升开发效率和系统的灵活性。