在以 Nacos 作为服务注册与服务发现的微服务部署架构里，出于高可用性考量，每个微服务通常会部署至少两个实例。然而，在线上服务部署过程中，当停止其中一个实例时，因 Gateway 更新存在延迟，在新服务启动阶段，仍会有请求被错误分配至该已停止实例，进而致使前端调用服务出现不可用状况。本文旨在从Nacos工作机制出发，详细阐述一种借助 Nacos API 达成前端无感知的微服务部署方法，为解决该问题提供有效思路与方案 。
一. Nacos 服务注册与发现的工作机制
1. 服务注册流程
（1）服务实例启动
当一个服务实例启动时，它会读取配置文件中关于 Nacos 服务注册中心的地址信息。
（2）发送注册请求
服务实例使用 Nacos 客户端 SDK 向 Nacos 服务端发送注册请求，请求中包含服务实例的相关信息。例如，在 Spring Cloud 应用中，Spring Cloud Alibaba Nacos Discovery 会自动完成这一过程。
（3）Nacos 服务端处理
Nacos 服务端接收到注册请求后，会将服务实例信息存储在内存中的服务注册表中，并持久化到磁盘，以防止数据丢失。同时，Nacos 会为该服务实例分配一个唯一的实例 ID。
（4）心跳机制
服务实例注册成功后，会定期向 Nacos 服务端发送心跳包，以表明自己处于健康状态。Nacos 服务端会根据心跳信息判断服务实例的健康状态，如果在一定时间内没有收到某个服务实例的心跳包，会将其标记为不健康。
2.服务注销流程
（1）主动注销
- 服务实例关闭：当服务实例需要正常关闭时，会调用 Nacos 客户端 SDK 的注销方法，向 Nacos 服务端发送注销请求。
- 从Nacos管理后台下线微服务。
- 通过Nacos API下线微服务。
（2） 被动注销
- 心跳超时：如果 Nacos 服务端在一定时间内（由配置的心跳超时时间决定）没有收到某个服务实例的心跳包，会将该服务实例标记为不健康。
- 实例移除：经过一段时间（由配置的实例过期时间决定）后，Nacos 服务端会将标记为不健康的服务实例从服务注册表中移除。
（3）Nacos 服务端处理
Nacos 服务端接收到注销请求后，会从服务注册表中移除该服务实例的信息，并更新相关的服务元数据。
**（4）**通知订阅的客户端更新服务列表
3.部署思路
基于以上Nacos注销流程，我们可以在不停止微服务的情况下，先通过Nacos API使得某个微服务实例下线，在Nacos通知客户端（网关服务）更新服务列表后，再部署该实例。
二. 服务下线脚本
通过调用Nacos API nacos/v2/ns/instance，设置参数enabled=false，使服务在nacos中下线。
如果使用dubbo进行服务间通讯，则同时要把对应的dubbo服务也下线：
#!/bin/bash
# 定义一个数组来存储服务名称和端口号的映射
declare -A services_ports
services_ports[service1]=18001
services_ports[service2]=18002
declare -A dubbo_ports
dubbo_ports[service1]=20900
dubbo_ports[service2]=20901
username=nacos_username
password=nacos_password
server_ip=$1
service_name=$2
service_port=${services_ports[$service_name]}
dubbo_port=${dubbo_ports[$service_name]}
echo set $service_name service offline
curl -X PUT 'http://192.168.0.xx:8848/nacos/v2/ns/instance?namespaceId=prod&groupName=DEFAULT_GROUP&serviceName='$service_name'&ip='$server_ip'&port='$service_port'&clusterName=DEFAULT&enabled=false&username='$username'&password='$password''
echo ""
echo set $service_name dubbo service offline
curl -X PUT 'http://192.168.0.xx:8848/nacos/v2/ns/instance?namespaceId=prod&groupName=DUBBO_GROUP&serviceName='$service_name'&ip='$server_ip'&port='$dubbo_port'&clusterName=DEFAULT&enabled=false&username='$username'&password='$password''
echo ""
替换以下内容：
（1）脚本中的service1为具体的服务名称，端口号为对应服务的端口号。
（2）username为Nacos的用户名，password为nacos的密码。
（3）http://192.168.0.xx:8848 修改为nacos服务的地址和端口。
（4）修改Curl 命令后面的参数groupName的值为具体nacos中的group名称。
保存上面的脚本保存为set_service_off.sh,并设为可执行：
chmod +x set_service_off.sh
使用以下命令：
./set_service_off.sh ip service_name
其中ip为微服务所在服务器的ip；service_name 为脚本中定义的微服务名称
三. 服务网关更新服务列表
在调用服务下线后，等待1-3秒，将不再有请求分配到该实例上。可通过执行下线脚本后执行
sleep(3)
四. 部署微服务
通过脚本或者通过自动化部署平台集成服务下线和上线脚本。
五. 服务上线脚本
服务上线脚本可以复制服务上线脚本，修改Nacos API其中的参数enabled=true，来上线微服务。
#!/bin/bash
# 定义一个数组来存储服务名称和端口号的映射
declare -A services_ports
services_ports[service1]=18001
services_ports[service2]=18002
declare -A dubbo_ports
dubbo_ports[service1]=20900
dubbo_ports[service2]=20901
username=nacos_username
password=nacos_password
server_ip=$1
service_name=$2
service_port=${services_ports[$service_name]}
dubbo_port=${dubbo_ports[$service_name]}
echo set $service_name service offline
curl -X PUT 'http://192.168.0.xx:8848/nacos/v2/ns/instance?namespaceId=prod&groupName=DEFAULT_GROUP&serviceName='$service_name'&ip='$server_ip'&port='$service_port'&clusterName=DEFAULT&enabled=true&username='$username'&password='$password''
echo ""
echo set $service_name dubbo service offline
curl -X PUT 'http://192.168.0.xx:8848/nacos/v2/ns/instance?namespaceId=prod&groupName=DUBBO_GROUP&serviceName='$service_name'&ip='$server_ip'&port='$dubbo_port'&clusterName=DEFAULT&enabled=true&username='$username'&password='$password''
echo ""
五.部署完后端，再部署前端
注意后端接口要做到向前兼容，即老版本前端可以和新版本后端交互。这样后端更新后，不影响老版本用户的使用，然后再更新前端web或者客户端。将上述脚本集成到你的自动化部署脚本中。