Higress项目中集群限流插件的rejected_code配置问题解析

问题背景

在Higress项目的集群限流插件（cluster-key-rate-limit）使用过程中，用户发现当基于特定key进行集群限流配置时，单独配置rejected_msg参数而不配置rejected_code参数时，自定义的拒绝消息不会生效。只有当同时配置了rejected_code（如设置为200）时，rejected_msg才会正常工作。

问题复现

通过用户提供的配置示例可以看出问题所在：

redis:
  service_name: "redis.dns"
  service_port: 6379
rejected_code: 200
rejected_msg: "{\"code\":-1,\"msg\":\"请求过于频繁，请稍后再试\"}"
rule_items:
- limit_by_header: "name"
  limit_keys:
  - key: "johnjan"
    query_per_second: 2
rule_name: "default_rule"
show_limit_quota_header: true

当移除rejected_code: 200这一配置项时，尽管rejected_msg仍然存在，但实际限流触发时不会返回预期的自定义消息。

问题原因分析

经过项目维护者检查，发现这是由于配置解析逻辑存在缺陷导致的。在代码实现中，对rejected_msg的处理依赖于rejected_code的存在，这种设计不够健壮。当用户仅配置rejected_msg而不配置rejected_code时，插件无法正确处理拒绝消息的返回逻辑。

解决方案

项目维护团队已经针对此问题进行了修复，主要改进点包括：

1. 解耦rejected_msg和rejected_code的依赖关系
2. 确保rejected_msg可以独立配置并生效
3. 提供更合理的默认值处理机制

修复后的版本已经发布，用户可以通过拉取最新镜像来获取修复后的功能：

higress-registry.cn-hangzhou.cr.aliyuncs.com/plugins/cluster-key-rate-limit:latest

最佳实践建议

对于使用Higress集群限流插件的用户，建议：

1. 及时更新到最新版本的插件镜像
2. 即使不需要自定义HTTP状态码，也可以考虑显式设置rejected_code以获得更明确的行为
3. 测试环境验证配置效果后再部署到生产环境

总结

这个问题展示了在插件开发中配置项之间依赖关系处理的重要性。良好的插件设计应该确保各配置项尽可能独立，或者提供清晰的文档说明依赖关系。Higress团队对此问题的快速响应和修复也体现了项目对用户体验的重视。