推空保护

使用限制

Nacos Java Client 1.4.1及以上版本支持客户端推空保护功能。

操作步骤

• 若您使用的是Java版本的Nacos-Client。

  1. 引入nacos-client依赖：

     <!-- ${nacos-client.version} 需为1.4.1及以上版本 -->
     <dependency>
         <groupId>com.alibaba.nacos</groupId>
         <artifactId>nacos-client</artifactId>
         <version>${nacos-client.version}</version>
     </dependency>

  2. 在程序代码中按照下列方式配置：

     Properties properties = new Properties();
     properties.put(PropertyKeyConst.SERVER_ADDR, "${mseNacos实例域名}");
     properties.put(PropertyKeyConst.NAMING_PUSH_EMPTY_PROTECTION, "true");
     NamingService naming = NamingFactory.createNamingService(properties);

• 若您使用的是Spring Cloud Alibaba框架，请在应用配置文件添加下列配置。

  spring.cloud.nacos.discovery.namingPushEmptyProtection=true

• 若您使用的是Dubbo框架，请在Dubbo配置文件的注册中心链接URL中添加下列配置。

  dubbo.registry.address=nacos://${mseNacos实例域名}:8848?namingPushEmptyProtection=true

使用限制

Nacos引擎版本需升级至2.1.0.0及以上。具体操作，请参见升级引擎版本。

操作步骤

Nacos引擎的版本不同，开启推空保护的方式也有所不同。

• 若您的MSE Nacos引擎版本为2.1.0.0或2.1.0.1，无需任何操作，对应版本会自动开启推空保护。

• 若您的MSE Nacos引擎版本为2.1.0.2及以上，需要通过以下操作开启推空保护。

  1. 登录MSE注册配置中心管理控制台，并在顶部菜单栏选择地域。

  2. 在左侧导航栏，选择注册配置中心 > 实例列表。

  3. 在实例列表页面，单击目标实例名称。

  4. 在左侧导航栏，单击参数设置。在参数设置页面的实时生效参数区域，单击forcePushEmptyProtectionForAllService右侧操作列下方的编辑。

  5. 在参数编辑对话框，选中值右侧的是，然后单击确定。

     说明

     为保证业务的最高可用性，建议所有情况下均开启推空保护，即forcePushEmptyProtectionForAllService的值均选择是。

结果验证

当有服务触发推空保护时，您可以在服务消费者（Consumer）所处节点上的${user.home}/logs/nacos/naming.log日志中看到Trigger push empty protection for Service字样。

正常情况下，该信息不会频繁出现，如果频繁出现，可根据以下情况进行排查和治理。

• 订阅不存在的服务。

  如果应用订阅不存在的服务，需要排查该应用是否仍需要该依赖关系。如不需要，删除该无效依赖；如仍然需要，需重新发布上线该服务的提供者。

• 应用订阅的服务提供者为空。

  • 查看该服务的提供者是否频繁掉线。

  • 查看该服务的提供者是否与MSE Nacos集群的网络连接不健康，导致Nacos认为此服务的提供者已经下线。

定位触发推空保护的服务

错误信息中包含触发推空保护的服务。您可以通过Service{namespace='XXX'、group='xx'、name='xxxxxxx'、ephemeral=true、revision=0}得知服务消费者已订阅哪个空服务。

已知容易触发推空保护的主要场景

强制进行推空保护的场景

MSE Nacos 2.1.0.2及以上版本，引擎对推空保护的逻辑进行了优化，仅在开启forcePushEmptyProtectionForAllService时保护所有空服务列表。但若在以下场景，即使forcePushEmptyProtectionForAllService开关为关闭状态，为保证可用性和稳定性，系统仍然会自动启动推空保护能力。

• 引擎节点在进行升级、重启或故障自愈时，节点将所有服务自动开启2分钟的推空保护，以保证此期间用户业务可用性。

• 当服务下所有实例全部移除时，集群将针对该服务自动开启1分钟的推空保护，防止因网络抖动、服务提供者短时间内发生故障等问题导致的异常推空，以保证此场景下用户业务可用性。