首页
/ Apache ShenYu Nacos同步模式下规则缓存删除问题分析

Apache ShenYu Nacos同步模式下规则缓存删除问题分析

2025-05-28 07:49:21作者:卓艾滢Kingsley

问题背景

Apache ShenYu作为一款高性能的API网关,支持多种配置中心进行数据同步。在使用Nacos作为同步中心时,发现了一个关于规则缓存删除的缺陷:当通过管理界面删除某个规则后,网关节点中的缓存未能正确清除,导致已删除的规则仍然可以继续匹配和路由请求。

问题现象

具体表现为:

  1. 创建选择器和规则后,接口可以正常访问
  2. 删除规则后,管理界面显示规则列表为空
  3. 再次访问接口时,仍然能获得正确响应,而不是预期的"Rule not found"错误

技术原理分析

ShenYu网关采用多级缓存机制来提高性能。当使用Nacos作为同步中心时,数据同步流程如下:

  1. 管理端修改规则后,会通过Nacos的配置变更机制通知所有网关节点
  2. 网关节点接收到变更事件后,会解析事件内容并更新本地缓存
  3. 请求处理时,网关会优先检查本地缓存中的路由规则

问题根源

通过代码分析发现,问题出在Nacos配置变更事件的解析环节:

  1. 当规则被删除时,Nacos会发送配置删除事件
  2. 网关需要从事件key中解析出selectorId和ruleId
  3. 当前解析逻辑存在缺陷,导致获取的selectorId和ruleId不正确
  4. 由于ID不正确,无法从RULE_MAP缓存中找到对应的规则进行删除

解决方案

修复方案需要正确处理Nacos的key解析逻辑:

  1. 确保从Nacos事件key中准确提取selectorId和ruleId
  2. 在RULE_MAP缓存中精确删除对应的规则数据
  3. 添加必要的日志输出,便于问题排查

影响范围

该问题影响所有使用Nacos作为同步中心的ShenYu网关部署,版本包括最新的master分支和v2.7.0标签。

最佳实践建议

对于遇到类似问题的用户,建议:

  1. 检查网关日志,确认规则删除事件是否被正确处理
  2. 临时解决方案可以重启网关节点强制刷新缓存
  3. 关注官方修复版本,及时升级

总结

配置同步是网关系统的核心功能之一,缓存一致性保证尤为重要。这个问题提醒我们,在使用分布式配置中心时,需要特别注意删除操作的传播和处理逻辑。Apache ShenYu社区已经注意到这个问题并着手修复,体现了开源项目快速响应问题的优势。

登录后查看全文
热门项目推荐
相关项目推荐