Tendis集群迁移slot报错问题分析与解决方案

问题现象

在使用TendisPlus 2.7.0版本搭建的Redis集群环境中，用户在执行cluster setslot命令进行数据迁移时遇到了"json parse fail"错误。具体表现为无论尝试迁移单个slot还是slot范围，系统均返回相同的错误信息。

错误复现

用户搭建了一个3节点的空集群环境，节点分布如下：

• 节点1: 172.x.34.46:3689，负责slot 0-5461
• 节点2: 172.x.32.162:3689，负责slot 5462-10922
• 节点3: 172.x.33.94:3689，负责slot 10923-16383

在执行以下命令时均出现错误：

cluster setslot importing 684ec60c6dded4870c1cf9fdf84b4d50b66c54a5 7365
cluster setslot importing 684ec60c6dded4870c1cf9fdf84b4d50b66c54a5 {7365..7366}
cluster setslot importing 684ec60c6dded4870c1cf9fdf84b4d50b66c54a5 10922

问题分析

1. 初步排查：从错误信息"json parse fail"来看，问题可能出在集群节点间通信时的数据解析环节。Tendis集群节点间通信通常使用JSON格式交换数据。

2. 配置检查：用户反馈集群只配置了requirepass参数，而没有配置masterauth参数。在Redis/Tendis集群环境中，这两个认证参数的配置有特定要求：

   • requirepass：用于客户端连接认证
   • masterauth：用于节点间通信认证

3. 根本原因：当集群节点间需要通信执行cluster setslot这类管理命令时，如果只设置了requirepass而没有设置masterauth，会导致节点间认证失败。由于认证失败后的错误处理机制可能不够完善，最终表现为JSON解析错误。

解决方案

1. 完整认证配置：在集群所有节点的配置文件中，同时设置requirepass和masterauth参数，且值应该相同：

   requirepass yourpassword
   masterauth yourpassword
   

2. 配置生效：修改配置后需要重启集群节点使配置生效。

3. 验证步骤：

   • 确认所有节点配置一致
   • 检查集群状态是否健康
   • 再次尝试slot迁移操作

最佳实践建议

1. 集群部署规范：在部署Tendis集群时，建议同时配置requirepass和masterauth，即使暂时不需要客户端认证也应保持两者一致。

2. 错误排查流程：

   • 首先检查基础网络连通性
   • 确认集群节点状态是否正常
   • 检查认证相关配置是否完整
   • 查看日志获取更详细的错误信息

3. 版本注意事项：不同版本的Tendis/Redis在错误提示上可能有差异，建议在测试环境充分验证后再上线生产环境。

总结

Tendis集群在slot迁移操作时出现"json parse fail"错误，往往是由于节点间通信认证配置不完整导致的。通过正确配置masterauth参数，可以解决此类问题。这也提醒我们在分布式数据库环境部署时，需要全面考虑各种交互场景下的认证需求，确保配置的完整性。