Sidekiq闲置一段时间后触发RedisClient::ReadTimeoutError求助

核心问题 #

报错RedisClient::ReadTimeoutError: Waited 7 seconds本质是Sidekiq复用了已失效的Redis连接，闲置一段时间后触发，和crontab/whenever/sidekiq-cron等调度工具无关，核心矛盾在Redis连接的生命周期管理。

常见触发原因 #

1. Redis服务器主动断开闲置连接
   Redis默认配置timeout参数（默认300秒），如果连接长时间无交互，Redis会主动关闭连接。Sidekiq连接池中的旧连接未被检测到失效，复用阶段就会触发超时。

2. 网络中间件强制断开TCP连接
   防火墙、NAT网关或负载均衡器通常会主动断开长时间闲置的TCP连接（默认几分钟到几十分钟），导致Sidekiq持有的连接变成无效的“僵尸连接”。

3. Sidekiq连接配置未适配闲置场景
   当前仅设置network_timeout:5，缺少连接有效性检测、失效重连的相关配置，无法自动剔除连接池中的失效连接。

针对性解决方案 #

1. 调整Redis服务器超时设置 #

修改Redis配置文件（redis.conf），延长超时时间或禁用超时：

# 延长至1小时（3600秒），根据业务场景调整
timeout 3600
# 或者禁用超时（生产环境需评估内存占用后使用）
# timeout 0

修改后重启Redis服务。

2. 优化Sidekiq的Redis连接配置 #

更新config/initializers/sidekiq.rb，添加连接健康检测、重连尝试等参数：

Sidekiq.configure_client do |config|
  config.redis = {
    url: ENV['REDIS_URL'],
    size: 10,
    network_timeout: 10, # 适当延长超时时间
    reconnect_attempts: 3, # 增加重连次数
    health_check_interval: 60, # 每分钟检测一次连接有效性
    pool_timeout: 5 # 获取连接的超时时间，避免长时间阻塞
  }
end

Sidekiq.configure_server do |config|
  config.redis = {
    url: ENV['REDIS_URL'],
    size: 10,
    network_timeout: 10,
    reconnect_attempts: 3,
    health_check_interval: 60,
    pool_timeout: 5
  }
end

• health_check_interval：让Redis客户端定期检测连接状态，自动剔除失效连接
• reconnect_attempts：连接失效时自动尝试重连
• 调大network_timeout，避免因Redis短暂响应慢触发超时

3. 配置服务器TCP保活机制 #

避免网络中间件断开闲置连接，在Linux服务器上开启TCP keepalive：

echo "net.ipv4.tcp_keepalive_time = 600" >> /etc/sysctl.conf
echo "net.ipv4.tcp_keepalive_intvl = 60" >> /etc/sysctl.conf
echo "net.ipv4.tcp_keepalive_probes = 5" >> /etc/sysctl.conf
sysctl -p

内容的提问来源于stack exchange，提问作者chelosobaka