动态与公告

产品动态

公告

新手指引

产品简介

产品概述

产品优势

应用场景

存储引擎

产品系列

产品版本

规格与性能

读写分离

多可用区部署

地域和可用区

名词解释

购买指南

计费概述

定价中心

购买实例

续费说明（包年包月）

退费说明（包年包月）

欠费说明

按量转包年包月

快速入门

快速创建实例

连接 Redis 实例

操作指南

操作总览

连接数据库实例

管理实例

升级实例

管理节点（Redis/ValKey 版）

管理多可用区

备份与恢复

账号管理

参数配置

慢查询

访问管理

网络与安全

监控与告警

事件管理（Redis/ValKey 版）

数据迁移

Redis 版全球复制

数据库审计

诊断优化

Sentinel 模式

开发准则

命名规则

基本使用准则

Key 与 Value 设计原则

命令使用准则

客户端程序设计准则

连接池配置

命令参考

命令参考概览

Redis 版与 Valkey 版命令兼容性

大版本命令使用差异

Proxy 架构与直连模式的使用差异

命令更多操作（Redis/Valkey 版）

Memcached 版命令兼容性

实践教程

基于 Spring Boot 搭建 Redis 客户端监控

Redis 客户端连接配置策略与实践

集群架构全局 SCAN 使用指南

实例安全下线

热 Key 与大 key

可用区迁移方案

故障处理

连接异常

Redisson 客户端超时重连异常分析及解决方案

性能排查与调优

API 文档

History

Introduction

API Category

Making API Requests

Instance APIs

Parameter Management APIs

Other APIs

Backup and Restoration APIs

Region APIs

Monitoring and Management APIs

Log APIs

Data Types

Error Codes

常见问题

使用常见问题

连接登录问题

购买相关问题

版本推荐

PDF

聚焦模式

字号

最后更新时间： 2026-03-17 18:23:48

Redisson 是一个基于 Netty 实现的高性能、线程安全的 Redis Java 客户端，它提供了丰富的分布式对象和分布式服务，如分布式锁、分布式集合、分布式队列等，极大地简化了 Redis 在分布式环境中的使用，让开发者能够更便捷地构建分布式应用。
说明：
腾讯云通过 VIP（（Virtual IP Address）） 代理层统一屏蔽了 Redis 底层架构的复杂性（分片/高可用）。Redission 客户端访问腾讯云 Redis 实例时，无需配置集群或哨兵模式，而是像连接单节点 Redis 一样，直接访问腾讯云提供的统一入口 VIP。
推荐版本
综合评估，建议选择 Redisson 3.24.3 版本，单机连接模式。该版本稳定性和功能性得到验证，并且其他版本存在的问题得到了解决。具体信息，请参见 3.24.3 released。
其他版本
版本信息
核心问题
修复说明
Redisson < 3.21.0
在 Redis 集群模式下，当后端节点发生变更时（如故障转移、扩缩容增减节点），Redisson 客户端未正确释放旧节点连接，导致连接池一定概率出现连接泄漏。
Redisson 3.21.0 已解决该问题。具体说明，请参见Redisson Releases History。
﻿
Redisson < 3.17.5
Redis 集群发生副本节点变更（HA 切换、扩缩容、变配），会因副本刷新不正确而导致 Redission 加锁异常。
Redisson 3.17.5 已解决该问题。具体说明，请参见 Error while attempting to set lock。
Redisson < 3.18.1
当发生网络异常或机器宕机导致连接中断时，若业务系统正在使用分布式锁，所有获取锁的连接将被持续占用无法释放，客户端持续抛出java.util.concurrent.CancellationException 错误，最终导致整个分布式锁功能完全不可用。
具体修复方法，请参见 Fixed - RLock throws CancellationException continuously。
Redisson > 3.44.0
Redisson 单机模式连接腾讯云 Redis，调用 tryLock 方法，其新增的续约锁机制会按线程数发送 Lua 脚本，导致跨 slot 操作错误。
说明：
Redisson 集群模式可解决该问题，但需验证建连阶段是否因集群发现机制与 VIP 架构冲突引发异常，实例变配（如扩容）时 VIP 切换是否影响客户端稳定性。
在单机模式下解决该问题，需将lockWatchdogBatchSize参数显式设置为1。此配置将强制 Redisson 的锁批量续期机制以单线程串行化方式执行 Lua 脚本，确保每次续期操作仅处理单个 Key，从而规避跨 slot 错误。
﻿
// Config中有一个setLockWatchdogBatchSize可以进行设置，比如
public RedissonClient redissonClient(){
    Config redissonConfig = new Config();
    redissonConfig.setLockWatchdogBatchSize(1);
}

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

腾讯云分布式缓存数据库（兼容 Redis）

版本推荐

推荐版本

其他版本

帮助和支持

版本信息	核心问题	修复说明
Redisson < 3.21.0	在 Redis 集群模式下，当后端节点发生变更时（如故障转移、扩缩容增减节点），Redisson 客户端未正确释放旧节点连接，导致连接池一定概率出现连接泄漏。	Redisson 3.21.0 已解决该问题。具体说明，请参见Redisson Releases History。
Redisson < 3.17.5	Redis 集群发生副本节点变更（HA 切换、扩缩容、变配），会因副本刷新不正确而导致 Redission 加锁异常。	Redisson 3.17.5 已解决该问题。具体说明，请参见 Error while attempting to set lock。
Redisson < 3.18.1	当发生网络异常或机器宕机导致连接中断时，若业务系统正在使用分布式锁，所有获取锁的连接将被持续占用无法释放，客户端持续抛出`java.util.concurrent.CancellationException` 错误，最终导致整个分布式锁功能完全不可用。	具体修复方法，请参见 Fixed - RLock throws CancellationException continuously。
Redisson > 3.44.0	Redisson 单机模式连接腾讯云 Redis，调用 tryLock 方法，其新增的续约锁机制会按线程数发送 Lua 脚本，导致跨 slot 操作错误。说明： Redisson 集群模式可解决该问题，但需验证建连阶段是否因集群发现机制与 VIP 架构冲突引发异常，实例变配（如扩容）时 VIP 切换是否影响客户端稳定性。	在单机模式下解决该问题，需将`lockWatchdogBatchSize`参数显式设置为1。此配置将强制 Redisson 的锁批量续期机制以单线程串行化方式执行 Lua 脚本，确保每次续期操作仅处理单个 Key，从而规避跨 slot 错误。 // Config中有一个setLockWatchdogBatchSize可以进行设置，比如 public RedissonClient redissonClient(){ Config redissonConfig = new Config(); redissonConfig.setLockWatchdogBatchSize(1); }