帮你快速理解、总结文档立即下载
文档中心>腾讯云分布式缓存数据库（兼容 Redis）>实践教程>Redis 客户端连接配置策略与实践>Lettuce 连接 Redis>参数配置

参数配置

最近更新时间：2025-07-01 11:17:01
我的收藏

本页目录：

基于 Lettuce 连接 Redis 的连接参数和连接池相关配置的推荐值，请参见下表，方便您快速搭建客户端。
参数名
类型
默认值
解释
推荐值
connectTimeout
int
10s
客户端尝试与 Redis 建立连接的最长等待时间
2s
commandTimeout
int
无
客户端发送请求，Redis 服务器响应超时时间
2s
tcpKeepaliveTimeIdle
int
2h
开启 keepalive 后，连接空闲多久就会开始发送 keepalive 探测
30s
tcpKeepaliveTimeInterval
int
75s
开启 keepalive 后，两次 keepalive 间的时间间隔，推荐值10s
10s
tcpKeepaliveCount
int
9
开启 keepalive 后，Tcp 在断开连接前应发送的最大 Keepalive 探测次数
3
tcpUserTimeout
int
7875s
Tcp 在放弃重传数据并关闭连接之前，等待确认的最大时间
30s
poolMaxwait
int
无
当连接池中没有可用连接时，调用者最多等待的时间
1000ms
poolMaxActive
int
8
连接池可以分配的最大连接总数，请根据业务具体情况设置
-
poolMaxIdle
int
8
连接池中允许保持的最大空闲连接数，请根据业务具体情况设置
-
poolMinIdle
int
0
连接池中允许的最小空闲连接数，请根据业务具体情况设置
-

application.properties 格式

# Host、Port、Database、Password与代码配置2选1
spring.data.redis.host=XX.XX.XX.XX
spring.data.redis.port=6379
spring.data.redis.password=XXXX
spring.data.redis.database=0

#tencent.redis.host=XX.XX.XX.XX
#tencent.redis.port=6379
#tencent.redis.database=0
#tencent.redis.password=XXXX
tencent.redis.connect.timeout=2000
tencent.redis.command.timeout=2000
tencent.redis.tcp.keepalive.time.idle=30
tencent.redis.tcp.keepalive.time.interval=10
tencent.redis.tcp.keepalive.count=3
tencent.redis.tcp.user.timeout=30

tencent.redis.pool.max-wait=1000
tencent.redis.pool.max-active=2000
tencent.redis.pool.max-idle=1000
tencent.redis.pool.min-idle=500

application.yml 格式


# Spring Boot 默认Redis配置
spring:
  data:
    redis:
      host: XX.XX.XX.XX
      port: 6379
      password: XXXX
      database: 0

# 自定义Tencent Redis配置
tencent:
  redis:
    # host: XX.XX.XX.XX
    # port: 6379  
    # database: 0
    # password: XXXX
    
    connect.timeout: 2000
    command.timeout: 2000
    tcp:
      keepalive:
        time.idle: 30
        time.interval: 10
        count: 3
      user.timeout: 30
    pool:
      max-wait: 1000
      max-active: 2000
      max-idle: 1000
      min-idle: 500
中国站