Redis配置中的timeout怎么设置

Redis 配置中的 timeout 设置指南

作用与默认值

• timeout 用于设置客户端连接在空闲（无命令交互）超过指定时间后被服务器主动关闭，单位为秒。默认值为 0，表示永不超时。合理设置可释放空闲连接、降低资源占用，避免连接池被异常连接占满。

配置方式

• 修改配置文件
  • 打开配置文件（常见路径：/etc/redis/redis.conf），找到或添加：

    timeout 300
    

    保存后重启服务（如：systemctl restart redis）使配置持久化生效。
• 动态修改（运行时）
  • 通过 redis-cli 执行：

    CONFIG SET timeout 300
    

    该方式立即生效，但重启后会恢复为配置文件中的值，建议随后写入配置文件以保持持久化。
• 启动命令行参数
  • 启动 Redis 时指定：

    redis-server --timeout 10
    

    适合临时调整或容器化场景的入口参数覆盖。

常用取值与影响

• 0：不主动关闭空闲连接，适合长连接或连接由客户端/连接池严格管理的场景。
• > 0：空闲超过该值将被服务器关闭。设置过短会导致频繁重连与额外开销；设置过长会占用连接资源。常见取值如 60/300/600 秒，应结合业务空闲时长与连接池配置综合评估。

验证与注意事项

• 验证生效
  • 在 redis-cli 中查看：

    CONFIG GET timeout
    

    返回值即为当前生效的超时时间（秒）。
• 清理延迟与保活
  • Redis 对超时的清理存在一定调度延迟；如需更快回收，可适当增大 hz（提升定时任务频率）。同时可配合 tcp-keepalive 让操作系统定期发送心跳，帮助及早发现半开连接（注意：tcp-keepalive 是网络层保活，不等价于应用层的 timeout）。
• 云数据库与托管实例
  • 部分云厂商的集群版/读写分离版可能不支持自定义 timeout，需在控制台或实例规格允许的范围内调整，或改由客户端/连接池超时策略控制。
• 客户端侧超时区分
  • 客户端库的超时（如 socket_timeout）是客户端发起请求的 I/O 超时，与服务器端的 timeout（空闲关闭）互不替代。生产环境通常同时配置两者：服务器侧用于回收空闲连接，客户端侧用于快速失败与容错。