动态与公告

产品动态

公告

新手指引

产品简介

产品概述

产品优势

应用场景

存储引擎

产品系列

产品版本

规格与性能

读写分离

多可用区部署

地域和可用区

名词解释

购买指南

计费概述

定价中心

购买实例

续费说明（包年包月）

退费说明（包年包月）

欠费说明

按量转包年包月

快速入门

快速创建实例

连接 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

基于 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

帮助和支持

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

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

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

文档反馈

tencent cloud

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

参数配置

application.properties 格式

application.yml 格式

帮助和支持

参数名	类型	默认值	解释	推荐值
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	连接池中允许的最小空闲连接数，请根据业务具体情况设置	-