【Spring Cloud Alibaba】Nacos(一)

【Spring Cloud Alibaba】Nacos

• 0. Spring Cloud Alibaba 组件
• 1. 什么是Nacos，它都能干什么？
• • 1.1 注册中心演变及其思想
  • 1.2 Nacos Discovery
  • 1.3 远程调用流程图
  • 1.4 一个微服务的流程
  • 1.4 常用注册中心对比
• 2. Nacos Server部署
• 3. Nacos Client搭建
• 4. Nacos管理界面详细介绍
• • 4.1 服务列表&命名空间
  • 4.2 订阅者列表
  • • 📌 经常被误解的点
• 5. 注册中心配置项
• 6. 版本问题
• • 6.1 **新项目（2026 年）**：优先选 **2023.0.1.0 + Spring Boot 3.2.x**，生态成熟、组件稳定，JDK 17 即可
  • 6.1 老一些的版本
• 附录

0. Spring Cloud Alibaba 组件

SpringCloudAlibaba├── 注册与配置中心 │ ├──Nacos│ │ ├── 服务注册与发现 │ │ ├── 服务健康检查 │ │ ├── 动态配置中心 │ │ └── 灰度发布支持 │ ├──SentinelDataSource(从Nacos拉规则)│ └──Dubbo注册中心（可作为） │ ├── 服务限流与容错 │ ├──Sentinel│ │ ├── 流量控制（QPS、线程数） │ │ ├── 熔断降级（异常比例、RT） │ │ ├── 系统保护（负载、CPU） │ │ ├── 热点参数限流 │ │ └── 集群限流 │ ├── 分布式事务 │ ├──Seata│ │ ├──AT模式（无侵入） │ │ ├──TCC模式 │ │ ├──Saga模式 │ │ └──XA模式 │ ├──RPC与服务通信 │ ├──Dubbo│ │ ├── 高性能RPC│ │ ├── 服务治理（路由、负载均衡） │ │ ├── 异步调用 │ │ ├──Triple协议（gRPC兼容） │ │ └──Nacos/配置中心整合 │ ├──SpringCloudOpenFeign增强 │ │ └──SentinelFeign限流熔断支持 │ ├── 消息与事件驱动 │ ├──RocketMQ│ │ ├── 高吞吐消息队列 │ │ ├── 事务消息 │ │ ├── 延时消息 │ │ ├── 顺序消息 │ │ └── 消费重试与DLQ│ └──SpringCloudStreamBinderRocketMQ│ ├── 负载均衡与路由 │ ├──SpringCloudLoadBalancer(替代Ribbon)│ ├──Sentinel+Nacos路由治理 │ └──DubboSDK负载均衡 │ ├── 网关 │ ├──SpringCloudGateway+Nacos│ │ ├── 动态路由 │ │ ├──Sentinel网关限流 │ │ └── 权限认证/灰度 │ ├── 分布式任务与调度 │ ├──SchedulerX（阿里任务调度） │ │ ├── 定时任务 │ │ └── 分布式调度 │ ├── 分布式存储 │ ├──OSS│ │ ├── 对象存储SDK│ │ └── 文件上传/下载 │ └── 监控与可观测性 ├──ARMS（应用监控） ├──Prometheus/Grafana整合 └──SentinelDashboard

1. 什么是Nacos，它都能干什么？

官方文档 https://www.nacos.io/docs/latest/overview/?spm=55c5c5db.2ef5001f.0.0.73a53b7cJujobM

在Spring Cloud Alibaba套件中服务治理方面的核心组件是Nacos(Dynamic Naming and Configuration Service),在Spring Cloud Alibaba套件为基础的微服务中，Nacos担当的角色有服务发现和健康检测、服务注册中心(动态注册)、配置中心(动态配置)、服务元数据管理等功能。

做为注册中心：Nacos管理所有的微服务，解决微服务调用之间的错综复杂、难以维护的问题。

1.1 注册中心演变及其思想

最开始的时候通过分布式架构，可以通过HTTP这中方式，需要提供被调用方服务的ip地址，但是被调用方的地址如果改变了，就需要手动的改变。

解决这个问题的方法，我们可以通过手动在MySQL中维护一个注册表，记录远程服务的ip地址，但这样存在问题某个服务水平扩容如何实现负载均衡，还有某个服务宕机了呢！

这一次引入nginx，但是成百上千的微服务使得nginx配置文件会非常的复杂。

随着注册中心的出现，它代替了nginx。
首先服务启动的时候，会调用注册接口，把当前的服务注册到注册表中，其他服务启动同样也会到注册表中注册一条信息，一个服务调用另一个服务会去注册中心去找对应的服务的名称、ip、端口。
其次，注册中心引入了心跳机制，每5秒发送一次心跳，防止有些服务的服务器宕机，却仍然被使用。
获取的服务会被缓存起来，客户端会有一个负载均衡。

1.2 Nacos Discovery

Nacos相关文档
github Nacos相关文档

服务发现是微服务架构体系中最关键的组件之一。如果尝试着用手动的方式来给每一个客户端来配置所有服务提供者的服务列表是一件非常困难的事，而且也不利于服务的动态扩缩容。Nacos Discovery Starter 可以帮助您将服务自动注册到 Nacos 服务端并且能够动态感知和刷新某个服务实例的服务列表。除此之外，Nacos Discovery Starter 也将服务实例自身的一些元数据信息-例如 host，port,健康检查URL，主页等注册到 Nacos 。

如何引入 Nacos Discovery Starter 如果要在您的项目中使用 Nacos 来实现服务发现，使用 group ID 为 com.alibaba.cloud 和 artifact ID 为 spring-cloud-starter-alibaba-nacos-discovery 的 starter。

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

Nacos Discovery 提供如下核心功能：

1. 服务注册：Nacos Client会通过发送REST请求的方式向Nacos Server注册自己的服务，提供自身的元数据，比如ip地址、端口等信息。Nacos Server接收到注册请求后，就会把这些元数据信息存储在一个双层的内存Map中。

2. 服务心跳：在服务注册后，Nacos Client会维护一个定时心跳来持续通知Nacos Server，说明服务一直处于可用状态，防止被剔除。默认5s发送一次心跳。

3. 服务同步：Nacos Server集群之间会互相同步服务实例，用来保证服务信息的一致性。leader raft

4. 服务发现：服务消费者 (Nacos Client) 在调用服务提供者的服务时，会发送一个REST请求给Nacos Server，获取上面注册的服务清单，并且缓存在Nacos Client本地，同时会在Nacos Client本地开启一个定时任务定时拉取服务端最新的注册表信息更新到本地缓存。

5. 服务健康检查：Nacos Server会开启一个定时任务用来检直注册服务实例的健康情况，对于超过15s没有收到客户端心跳的实例会将它的healthy属性置为false(客户端服务发现时不会发现)，如果某个实例超过30秒没有收到心跳，直接剔除该实例(被易余的实例如果恢复发送心跳则会重新注册）

1.3 远程调用流程图

1.4 一个微服务的流程

1.4 常用注册中心对比

在分布式系统中
CP（Consistency and Partition tolerance，一致性和分区容错性）
AP（Availability and Partition tolerance，可用性和分区容错性）
是两种常见的系统特性组合。
C一致性 A可用性 P分区容错性

组件的版本关系

2. Nacos Server部署

官网

解压后的结果：

复制conf中的mysql-schema.sql，到你的MySQL中建表。

========在windows中===========

修改为单机模式启动

3. Nacos Client搭建

父类pom依赖

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.study.springCloudAlibaba</groupId><artifactId>springcloudalibaba</artifactId><version>0.0.1-SNAPSHOT</version><name>springcloudalibaba</name><description>springcloudalibaba</description><modules><module>order</module><module>stock</module></modules><properties><java.version>1.8</java.version><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding><spring-boot.version>2.3.2.RELEASE</spring-boot.version></properties><packaging>pom</packaging><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId></dependency><!--nacos-discovery https://github.com/alibaba/spring-cloud-alibaba/wiki/Nacos-discovery--><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope><exclusions><exclusion><groupId>org.junit.vintage</groupId><artifactId>junit-vintage-engine</artifactId></exclusion></exclusions></dependency></dependencies><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>${spring-boot.version}</version><type>pom</type><scope>import</scope></dependency><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-alibaba-dependencies</artifactId><version>2.2.5.RELEASE</version><type>pom</type><scope>import</scope></dependency><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-dependencies</artifactId><version>Hoxton.SR8</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.8.1</version><configuration><source>1.8</source><target>1.8</target><encoding>UTF-8</encoding></configuration></plugin><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><version>${spring-boot.version}</version><configuration><mainClass>com.study.springcloudalibaba.springcloudalibaba.SpringcloudalibabaApplication</mainClass><skip>true</skip></configuration><executions><execution><id>repackage</id><goals><goal>repackage</goal></goals></execution></executions></plugin></plugins></build></project>

子类pom依赖

<?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>com.study.springCloudAlibaba</groupId><artifactId>springcloudalibaba</artifactId><version>0.0.1-SNAPSHOT</version></parent><artifactId>order</artifactId><properties><maven.compiler.source>8</maven.compiler.source><maven.compiler.target>8</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties><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-discovery</artifactId></dependency></dependencies></project>

项目结构

启动类

Controller

yml

Nacos中

4. Nacos管理界面详细介绍

4.1 服务列表&命名空间

========新建命名空间========

=====查看服务列表======

=======代码部分========

=======分组与命名空间的区别========
命名空间可以规划某个项目，然后这个项目下的所有服务都在这里。
分组就可以分为dev、test、prod等

=======保护阈值========
这个与雪崩保护有关，保护阈值的范围在0-1之间，比如设置0.5，当健康实力数/总实力数<0.5就会把不健康的实例也拿给你用，防止洪峰流量打击。

=======元数据========
元数据是服务实例的额外标签或信息，用于路由、灰度发布、版本区分、服务治理等用途。


=======权重========
权重越大分配的流量越大

4.2 订阅者列表

记录了当前有哪些 Consumer 在订阅某个服务的实例列表，并需要接受推送。

项目	服务列表（Service List）	订阅列表（Subscribers）
角色	Provider（服务提供者）	Consumer（服务消费者）
记录内容	所有已注册的服务及其实例	哪些客户端订阅了某个服务
使用目的	服务注册、心跳、健康检查	推送服务变更通知
是否代表调用关系	❌ 不代表	✔ 代表某消费端依赖某服务
什么时候变化？	Provider上下线、健康变化时	Consumer上下线、订阅/退订时

📌 经常被误解的点

1. 误区 1：服务列表和订阅列表是一回事
   → ❌ 完全不是
   服务列表关心 Provider 谁在提供服务
   订阅列表关心 Consumer 谁在用这个服务

2. 误区 2：订阅列表为空就代表没有人调用这个服务
   → ❌ 不一定
   比如使用 OpenFeign 的懒加载，调用之前不会订阅。

3. 误区 3：订阅列表越大代表压力越大
   → ✔ 对
   因为 Nacos 需要给所有订阅者推送实例变更。

服务列表是服务端注册信息，订阅列表是客户端监听列表。

5. 注册中心配置项

更多配置: https://github.com/alibaba/spring-cloud-alibaba/wiki/Nacos-discovery

权重设置

6. 版本问题

6.1新项目（2026 年）：优先选2023.0.1.0 + Spring Boot 3.2.x，生态成熟、组件稳定，JDK 17 即可

https://sca.aliyun.com/docs/2023/overview/version-explain/?spm=7145af80.1ef41eac.0.0.1fa12d5bOZZOLp

6.1 老一些的版本

https://github.com/alibaba/spring-cloud-alibaba/wiki/版本说明/c6dd0baa688809d57edbbf504bd3dc75bac88dd7

附录

1. 课程地址