Redisson集群拓扑更新异常问题分析与修复
2025-05-09 18:49:13作者:邬祺芯Juliet
问题背景
在Redis集群环境中,当发生主从切换时,Redisson客户端(3.28.0及以上版本)可能会出现集群拓扑信息更新不及时的问题。具体表现为客户端持续将请求发送到错误的节点(原主节点或新从节点),导致Redis返回MOVED错误,而客户端无法自动恢复,必须重启应用才能解决。
问题现象
用户报告在Redis集群频繁主从切换时,Redisson客户端会出现以下异常:
org.redisson.client.RedisTimeoutException: Unable to acquire connection!
NodeSource [slot=7685, addr=redis://10.225.91.213:6379, redisClient=null, redirect=MOVED, entry=null]
异常表明客户端尝试连接到一个已经不再是主节点的Redis实例,且无法自动更新集群拓扑信息。
问题复现
通过测试可以稳定复现该问题:
- 将Redis从节点提升为主节点
- 将原主节点重新提升回主节点
- 此时Redisson客户端拓扑信息不会更新
使用Arthas工具检查发现,Redisson内部的MasterSlaveEntry对象中包含了错误的主节点信息,与实际集群拓扑不一致。
问题分析
通过版本对比和日志分析,可以确定:
- 该问题从Redisson 3.28.0版本开始出现
- 在3.27.2及以下版本中,主从切换后客户端能正确更新拓扑
- 问题核心在于客户端在第二次主从切换(即恢复原主节点)时,未能正确接收和处理集群拓扑变更事件
日志分析显示:
- 第一次主从切换时,Redisson能正确记录变更
- 第二次切换回原主节点时,没有相关日志输出
- 客户端仍尝试向已降级为从节点的实例发送写请求
影响范围
该问题对系统的影响包括:
- 导致大量请求被错误路由,产生MOVED响应
- 在Tomcat Session Manager等场景下可能导致服务不可用
- 显著增加Redis集群的操作压力(OPs可能增长5倍)
解决方案
Redisson开发团队已在3.33.0版本中修复了该问题。对于无法立即升级的用户,临时解决方案包括:
- 降级到3.27.2版本
- 在应用层实现监控和自动恢复机制
- 优化Redis集群稳定性,减少不必要的主从切换
最佳实践建议
- 对于生产环境,建议使用稳定的Redisson版本(3.33.0及以上)
- 实施Redis集群健康监控,避免频繁主从切换
- 在客户端配置合理的重试机制和超时设置
- 定期检查客户端与集群拓扑的一致性
该问题的修复显著提升了Redisson在Redis集群不稳定场景下的健壮性,确保了分布式系统的高可用性。
登录后查看全文
热门项目推荐
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0216
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0138
uni-appA cross-platform framework using Vue.jsJavaScript08
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
SwanLab⚡️SwanLab - an open-source, modern-design AI training tracking and visualization tool. Supports Cloud / Self-hosted use. Integrated with PyTorch / Transformers / LLaMA Factory / veRL/ Swift / Ultralytics / MMEngine / Keras etc.Python00
tiny-universe《大模型白盒子构建指南》:一个全手搓的Tiny-UniverseJupyter Notebook03
项目优选
收起
deepin linux kernel
C
32
16
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
471
465
Ascend Extension for PyTorch
Python
758
968
昇腾LLM分布式训练框架
Python
186
231
本项目是CANN提供的神经网络类计算算子库,实现网络在NPU上加速计算。
C++
698
1.4 K
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。
C++
878
2.03 K
暂无描述
Dockerfile
780
5.08 K
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
70
22
本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本,由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用,3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。
Dart
1.04 K
271
Claude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed.
Get Started
Rust
2.08 K
216