Nacos健康检查机制

关注

原创最新推荐文章于 2025-12-16 19:30:00 发布 835 阅读 AI 写同款· GEO 优化 ›

Nacos心跳机制解读（含简单源码分析）心跳机制是一种用于监测和管理微服务可用性的机制，它用来维护注册中心和服务提供者之间的连接状态，并及时更新服务实例的状态信息。心跳机制包括两个主要组件：心跳发送方（客户端）和心跳接收方（服务端）。每隔几分钟发送一个固定信息给服务端，服务端收到后回复一个固定信息如果服务端几分钟内没有收到客户端信息则视客户端断开。发包方可以是客户也可以是服务端心跳发送方（Heartbeat Sender）：每个微服务都会定期发送称为心跳消息的请求到一个中央位置（例如注册中心或负载均衡器）。阅读详情

本章内容

健康检查类型

Nacos根据服务实例类型提供了两种健康检查机制：

临时实例：采用客户端主动上报心跳的方式进行健康检查。
持久实例：采用服务端主动探测的方式进行健康检查。

服务实例类型配置方式：

server:
  port: 8081
spring:
  application:
    name: order-server
  cloud:
    nacos:
      discovery:
        # ephemeral值：true-临时实例，false-持久实例，默认为：true
        ephemeral: true

临时实例健康检查

发送实例心跳接口

请求协议：HTTP（2.x版本新增gRPC）

请求类型：PUT

请求路径：/nacos/v1/ns/instance/beat

请求参数

响应编码

客户端发送心跳请求

服务启动时，向Nacos服务发送服务注册请求，如果服务实例为临时实例，则会向Nacos服务端发送心跳请求。

客户端发送心跳请求，如图所示：

处理流程：

1）服务启动时，向Nacos服务端发送服务注册请求，如果服务实例为临时实例，则会向Nacos服务端发送心跳请求。
2）构建心跳信息。
3）将心跳信息封装成Task（线程），并放入定时任务线程池中以固定频次（默认5秒/次）向Nacos服务端发送心跳。
4）根据服务端响应信息判断服务是否已注册，如果服务未注册，则向Nacos服务端发送服务注册请求。
5）延迟指定时间后继续向Nacos服务端发送心跳请求（即：定时向Naco服务端发送心跳请求）。

服务端处理心跳请求

Nacos服务端收到客户端心跳请求后，调用心跳检测接口对应的处理方法处理心跳请求。

服务端心跳处理请求包含两个步骤：

1）处理客户端心跳请求。
2）定时检测服务实例是否已过期。

处理客户端心跳请求

处理客户端心跳请求，如图所示：

处理流程：

1）接收客户端请求（即：调用InstanceController.beat()方法）。
2）解析请求参数，并根据请求参数构建心跳信息对象（RsInfo对象）。
3）根据namespaceId、serviceName、clusterName、ip、port等信息从注册表中获取服务实例信息，如果实例信息不存在，则根据心跳请求参数构建服务实例并向注册表中注册该服务实例。
4）构建客户端心跳处理器（ClientBeatProcessor）对象封装客户端心跳信息。
5）将客户端心跳处理器放入线程池中进行心跳处理。
6）根据集群名、ip、port等信息查找客户端对应的服务实例（即：发送心跳请求的服务实例）。
7）更新服务实例最后一次心跳时间为系统当前时间。

定时检测服务实例是否已过期

定时检测服务实例是否已过期，如图所示：

处理流程：

1）服务首次注册，创建服务并初始化（即：调用Service.init()方法）。
2）根据服务信息构建心跳检测任务（ClientBeatCheckTask），并开启一个定时任务以5秒/次的频率执行心跳检测任务。
3）获取服务中的所有临时实例，判断实例最后一次心跳时间距离当前时间是否超过心跳检测超时时长（默认为15s），超过心跳检测超时时长，则设置服务实例的健康状态为false，并发布一个服务变更事件和心跳超时事件。
4）判断实例最后一次心跳时间距离当前时间是否超过删除实例设定的超时时长（默认为30s），超过删除实例设定的超时时长，则将该实例从实例列表中移除。