Spring Boot 整合 Nacos 注册中心终极指南

news2025/3/31 20:09:57

在微服务架构中,配置管理和动态路由是核心需求。Nacos 作为阿里巴巴开源的动态服务发现、配置管理和服务管理平台,能够帮助开发者实现配置热更新、多环境共享配置以及动态路由管理。本文将结合 Spring BootSpring Cloud Gateway,手把手教你实现以下功能:包含版本选择、核心配置、心跳机制及常见问题

  1. 配置热部署:不重启服务实时更新配置(如Redis参数)。
  2. 共享配置:多服务复用同一份公共配置(如公共Redis、数据库连接)。
  3. 动态路由:通过Nacos动态调整网关路由规则

一、环境准备

1.1 组件版本要求

组件推荐版本说明
Spring Boot2.6.x长期支持版本
Spring Cloud Alibaba2021.0.5.0与Spring Boot 2.6.x兼容
Nacos Server2.0.3稳定生产版本

版本匹配至关重要! 参考官方版本关系

1.2 启动Nacos Server

# 单机模式启动(默认端口8848)
sh nacos/bin/startup.sh -m standalone

# 访问控制台
http://localhost:8848/nacos
默认账号:nacos/nacos

在这里插入图片描述


二、Spring Boot 整合步骤

2.1 手动添加依赖(可选)

若未通过Initializr创建,需添加:

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>2021.0.5.0</version>
</dependency>

<!-- Spring Cloud 版本管理 -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>2021.0.5.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

2.2核心配置

application.yml 配置示例:

spring:
  application:
    name: order-service  # 服务名称(Nacos按此名称分组)
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848  # Nacos地址
        namespace: dev  # 命名空间ID(非名称)
        group: PROD_GROUP  # 自定义分组
        ephemeral: false  # 是否临时实例(默认为true)
        # 高级配置
        metadata: 
          version: v1.0
          region: hangzhou

2.3 启用服务发现

在启动类添加注解:

@SpringBootApplication
@EnableDiscoveryClient  // 关键注解
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

三、高级配置技巧

3.1 心跳与健康检查

spring:
  cloud:
    nacos:
      discovery:
        # 心跳间隔(单位ms,默认5000)
        heart-beat-interval: 3000
        # 心跳超时(单位ms,默认15000)
        heart-beat-timeout: 10000
        # 实例过期时间(单位秒,默认90)
        instance-expire-seconds: 30

3.2 权重与保护阈值

spring:
  cloud:
    nacos:
      discovery:
        # 实例权重(0-1,默认1)
        weight: 0.8
        # 集群保护阈值(0-1,默认0)
        protection-threshold: 0.5

3.3 多网卡IP指定

spring:
  cloud:
    nacos:
      discovery:
        # 指定注册IP(Docker环境常用)
        ip: 192.168.1.100
        # 指定IP类型
        ip-type: IPv4

四、验证服务注册

4.1 检查控制台

登录Nacos控制台 → 服务列表 → 查看服务状态
在这里插入图片描述

4.2 查看注册日志

在应用启动日志中搜索:

2023-10-01 12:00:00 INFO  o.s.c.a.n.registry.NacosServiceRegistry  : nacos registry, order-service 192.168.1.100:8080 register finished

五、常见问题解决方案

5.1 服务未注册排查流程

  1. 检查Nacos Server是否正常运行
  2. 确认spring.cloud.nacos.discovery.server-addr配置正确
  3. 查看客户端日志是否有注册异常
  4. 验证网络连通性(telnet 8848)
  5. 检查版本兼容性

5.2 典型错误处理

错误现象Connection refused (Connection refused)
解决方案

spring:
  cloud:
    nacos:
      discovery:
        # 使用完整URL格式
        server-addr: http://nacos.example.com:8848

错误现象no server available
解决方案

// 添加JVM参数指定Nacos地址
-Dspring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

以上我们就做好了Nacos的配置接下来实现热部署、共享配置与动态路由

Spring Boot整合Nacos实现热部署、共享配置与动态路由

.项目依赖

pom.xml中添加依赖:

<!-- Spring Cloud Alibaba Nacos Config -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>2022.0.0.0</version>
</dependency>

<!-- Spring Cloud Gateway -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>

二、配置热部署与共享配置

1. 配置热更新

目标:修改Nacos中的配置后,应用实时生效(无需重启)。

步骤

  1. 创建配置文件
    在Nacos控制台新建配置,Data IDservice-order.yaml(格式为${spring.application.name}.yaml),内容如下:

    redis:
      host: 127.0.0.1
      port: 6379
    
  2. Spring Boot配置
    bootstrap.yml中指定Nacos配置源:

    spring:
      application:
        name: service-order
      cloud:
        nacos:
          config:
            server-addr: localhost:8848
            file-extension: yaml
            namespace: dev  # 可选,指定命名空间
    
  3. 动态刷新配置
    在需要热更新的Bean上添加@RefreshScope

    @RestController
    @RefreshScope
    public class ConfigController {
        @Value("${redis.host}")
        private String redisHost;
    
        @GetMapping("/redis-host")
        public String getRedisHost() {
            return redisHost;
        }
    }
    

验证

  • 修改Nacos中redis.host的值,访问/redis-host接口,观察返回值是否实时更新。

2. 共享公共配置

目标:多个服务复用同一份配置(如公共Redis、MySQL连接)。

步骤

  1. 创建共享配置
    在Nacos中新建common-redis.yaml,内容如下:

    redis:
      host: 192.168.1.100
      port: 6379
      password: 123456
    
  2. 服务引用共享配置
    修改服务的bootstrap.yml,添加共享配置:

    spring:
      cloud:
        nacos:
          config:
            shared-configs:
              - data-id: common-redis.yaml
                refresh: true  # 开启动态刷新
    

优先级

  • 服务私有配置 > 共享配置 > 默认配置。

三、Nacos整合Gateway实现动态路由

目标:通过Nacos动态管理网关路由规则,无需重启网关服务。

1. 配置动态路由
  1. 创建路由配置
    在Nacos中新建gateway-routes.yaml,内容如下(JSON格式):

    routes:
      - id: user-service
        uri: lb://service-user  # 负载均衡到用户服务
        predicates:
          - Path=/user/**
        filters:
          - StripPrefix=1
    
  2. Gateway监听Nacos配置
    添加NacosRouteDefinitionRepository类实现动态路由加载:

    @Component
    public class NacosRouteDefinitionRepository implements RouteDefinitionRepository {
        @Autowired
        private NacosConfigManager nacosConfigManager;
    
        @Override
        public Flux<RouteDefinition> getRouteDefinitions() {
            String config = nacosConfigManager.getConfigService()
                    .getConfig("gateway-routes.yaml", "DEFAULT_GROUP", 5000);
            List<RouteDefinition> routes = JSON.parseArray(config, RouteDefinition.class);
            return Flux.fromIterable(routes);
        }
    
        // 监听配置变化
        @PostConstruct
        public void init() {
            nacosConfigManager.getConfigService().addListener(
                    "gateway-routes.yaml", "DEFAULT_GROUP",
                    new AbstractListener() {
                        @Override
                        public void receiveConfigInfo(String configInfo) {
                            // 触发路由刷新
                            ApplicationEventPublisher.publishEvent(new RefreshRoutesEvent(this));
                        }
                    });
        }
    }
    
2. 验证动态路由
  • 初始路由生效:访问http://localhost:8080/user/1,请求应转发至service-user服务。
  • 动态更新:在Nacos中修改gateway-routes.yaml,添加新的路由规则,观察网关是否自动生效。

四、总结与最佳实践

核心功能总结
功能实现方案优势
热部署@RefreshScope + Nacos配置监听实时更新配置,避免服务重启
共享配置shared-configs引用公共Data ID统一管理,减少冗余配置
动态路由监听Nacos配置 + RefreshRoutesEvent灵活调整流量,支持灰度发布
注意事项
  1. 配置格式:Nacos中的动态路由需使用JSON或YAML格式。
  2. 性能优化:频繁配置更新可能影响网关性能,建议合理设置刷新间隔。
  3. 安全加固:Nacos配置需设置权限控制,避免敏感信息泄露。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/2321440.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

SQLServer列转行操作及union all用法

1.创建测试表及数据sql如下 create table ScoresTable( Name varchar(50), ChineseScore int, MathScore int ) insert into ScoresTable values(小张,90,95) insert into ScoresTable values(小王,98,99) 2.表中查询结果如下 3.现需列转行显示&#xff0c;每行显示 姓名…

【GL010】C++

1.C中的const关键字有哪些用法&#xff1f; 1.修饰变量&#xff1a;表示变量的值不可修改。 const int a 10; 2.修饰指针&#xff1a; const int* p&#xff1a; // 指针指向的内容不可修改。 int* const p&#xff1a; // 指针本身不可修改。 const int* const…

(Arxiv-2025)MagicDistillation:用于大规模人像少步合成的弱到强视频蒸馏

MagicDistillation&#xff1a;用于大规模人像少步合成的弱到强视频蒸馏 paper是HKUST发布在Arxiv 2025的工作 paper title&#xff1a;MagicDistillation: Weak-to-Strong Video Distillation for Large-Scale Portrait Few-Step Synthesis Project page&#xff1a;地址 Abst…

Excel(进阶篇):powerquery详解、PowerQuery的各种用法,逆透视表格、双行表头如何制作透视表、不规则数据如何制作数据透视表

目录 PowerQuery工具基础修改现有数据理规则PowerQuery抓取数据的两种方式多文件合并透视不同表结构多表追加数据透视追加与合并整理横向表格:逆透视 数据用拆分工具整理数据算账龄 不等步长值组合合并文件夹中所有文件PowerQuery处理CSV文件双行表头、带合并单元格如何做数据…

Simple-BEV的bilinear_sample 作为view_transformer的解析,核心是3D-2D关联点生成

文件路径models/view_transformers 父类 是class BiLinearSample(nn.Module)基于https://github.com/aharley/simple_bev。 函数解析 函数bev_coord_to_feature_coord的功能 将鸟瞰图3D坐标通过多相机&#xff08;针孔/鱼眼&#xff09;内外参投影到图像特征平面&#xff0…

同一个局域网的话 如何访问另一台电脑的ip

在局域网内访问另一台电脑&#xff0c;可以通过以下几种常见的方法来实现&#xff1a; ‌直接通过IP地址访问‌&#xff1a; 首先&#xff0c;确保两台电脑都连接在同一个局域网内。获取目标电脑的IP地址&#xff0c;这可以通过在目标电脑上打开命令提示符&#xff08;Windows系…

基于SpringBoot的名著阅读网站

作者&#xff1a;计算机学姐 开发技术&#xff1a;SpringBoot、SSM、Vue、MySQL、JSP、ElementUI、Python、小程序等&#xff0c;“文末源码”。 专栏推荐&#xff1a;前后端分离项目源码、SpringBoot项目源码、Vue项目源码、SSM项目源码、微信小程序源码 精品专栏&#xff1a;…

Excel(实战):INDEX函数和MATCH函数、INDEX函数实战题

目录 经典用法两者嵌套查值题目解题分析 INDEX巧妙用法让数组公式&#xff0c;自动填充所有、有数据的行/列INDEX函数和SEQUENCE函数 经典用法两者嵌套查值 题目 根据左表查询这三个人的所有数据 解题分析 INDEX函数的参数&#xff1a;第1个参数是选定查找范围&#xff0c…

uniapp超简单ios截屏和上传app store构建版本方法

​ 假如使用windows开发ios的应用&#xff0c;上架的时候&#xff0c;你会发现&#xff0c;上架需要ios应用多种尺寸的ios设备的截图&#xff0c;和需要xcode等工具将打包好的ipa文件上传到app store的构建版本。 大部分情况下&#xff0c;我们的公司都没有这么多款ios设备来…

Netty源码—5.Pipeline和Handler一

大纲 1.Pipeline和Handler的作用和构成 2.ChannelHandler的分类 3.几个特殊的ChannelHandler 4.ChannelHandler的生命周期 5.ChannelPipeline的事件处理 6.关于ChannelPipeline的问题整理 7.ChannelPipeline主要包括三部分内容 8.ChannelPipeline的初始化 9.ChannelPi…

MySQL小练习

目录 一、单表查询 二、多表查询 一、单表查询 素材&#xff1a; 表名&#xff1a;worker-- 表中字段均为中文&#xff0c;比如 部门号 工资 职工号 参加工作 等 CREATE TABLE worker ( 部门号 int(11) NOT NULL, 职工号 int(11) NOT NULL, 工作时间 date NOT NULL, 工资 float…

Apache Hive:基于Hadoop的分布式数据仓库

Apache Hive 是一个基于 Apache Hadoop 构建的开源分布式数据仓库系统&#xff0c;支持使用 SQL 执行 PB 级大规模数据分析与查询。 主要功能 Apache Hive 提供的主要功能如下。 HiveServer2 HiveServer2 服务用于支持接收客户端连接和查询请求。 HiveServer2 支持多客户端…

检波、限幅、钳位电路

检波电路&#xff1a; 类似调制收音机信号&#xff1a;输入的基波和载波叠加成调制信号&#xff08;信号需要长距离里传输&#xff0c;频率要高&#xff0c;M级别的频率&#xff0c;所以要把低频信号叠在高频信号&#xff0c;才能把低频信号长距离传输&#xff0c;最后到达接收…

学习threejs,使用TextGeometry文本几何体

&#x1f468;‍⚕️ 主页&#xff1a; gis分享者 &#x1f468;‍⚕️ 感谢各位大佬 点赞&#x1f44d; 收藏⭐ 留言&#x1f4dd; 加关注✅! &#x1f468;‍⚕️ 收录于专栏&#xff1a;threejs gis工程师 文章目录 一、&#x1f340;前言1.1 ☘️THREE.TextGeometry1.1.1 ☘…

Go红队开发—CLI框架(一)

CLI开发框架 命令行工具开发&#xff0c;主要是介绍开发用到的包&#xff0c;集成了一个框架&#xff0c;只要学会了基本每个人都能开发安全工具了。 该文章先学flags包&#xff0c;是比较经典的一个包&#xff0c;相比后面要学习的集成框架这个比较自由比较细化点&#xff0…

高效团队开发的工具与方法 引言

引言 在现代软件开发领域&#xff0c;团队协作的效率和质量直接决定了项目的成败。随着项目规模的扩大和技术复杂度的增加&#xff0c;如何实现高效团队开发成为每个开发团队必须面对的挑战。高效团队开发不仅仅是个人技术能力的简单叠加&#xff0c;更需要借助合适的工具和方…

【Java全栈进阶架构师实战:从设计模式到SpringCloudAlibaba,打造高可用系统】

&#x1f31f; 分享一个教程&#xff0c;助刚踏入IT行业、工作几年的老油条、或热爱学习的工作党们更上一层楼的&#xff01; &#x1f31f; ​适合人群&#xff1a;初中级Java开发者、求职面试备战者、技术提升党&#xff01; &#x1f4da; ​内容亮点&#xff1a; 1️⃣ ​…

[蓝桥杯 2023 省 A] 异或和之和

题目来自洛谷网站&#xff1a; 暴力思路&#xff1a; 先进性预处理&#xff0c;找到每个点位置的前缀异或和&#xff0c;在枚举区间。 暴力代码&#xff1a; #include<bits/stdc.h> #define int long long using namespace std; const int N 1e520;int n; int arr[N…

TDengine 3.3.2.0 集群报错 Post “http://buildkitsandbox:6041/rest/sql“

修复&#xff1a; vi /etc/hosts将buildkitsandbox映射为本机节点

vue数据重置

前言 大家在开发后台管理系统的过程中&#xff0c;一定会遇到一个表格的条件查询重置功能吧&#xff0c;如果说查询条件少&#xff0c;重置起来还算是比较简单&#xff0c;如果元素特别多呢&#xff0c;那玩意写起来可遭老罪喽&#xff0c;那今天就给大家整一个如何快速重置数…