Golang Redis包执行HSet时context超时问题排查

循环复用context是核心问题 #

如果你的ctx本身带有超时/截止时间（比如上游是用context.WithTimeout/context.WithDeadline创建的），那这就是报错的根源：

• 循环运行9-10秒后，原ctx的超时时间耗尽，后续所有基于该ctx的Redis HSet调用都会触发context deadline exceeded错误。
• context.WithValue仅给原ctx附加了键值对，不会重置或延长原ctx的超时时间，复用过期的ctx必然导致后续操作失败。

Redis超时设置是次要排查点 #

有可能相关，但结合报错时机（运行9-10秒后批量出现），优先级低于ctx问题：

• 如果Redis客户端未设置DialTimeout、ReadTimeout、WriteTimeout，当Redis服务响应缓慢或连接池耗尽时，也会触发超时，但这类问题通常不会严格卡在固定时间点批量报错。
• 仍建议检查Redis客户端配置，设置合理的超时参数，避免连接层面的隐患。

修复方案 #

1. 调整context使用方式：在循环内部为每次Redis请求创建独立上下文，或给单次请求设置短期超时：

   for _, ip := range ips {
       // 为当前请求创建带1秒超时的子上下文
       reqCtx, cancel := context.WithTimeout(ctx, time.Second)
       defer cancel()
       time.Sleep(time.Millisecond * time.Duration(delay))
       if err := ih.dc.add(reqCtx, ip, uint32(0)); err != nil {
           log.WithFields(log.Fields{GroupIp: ip}).Info(err)
           continue
       }
       numberOfCreatedGroups += 1
   }
   

2. 完善Redis客户端配置：初始化时明确设置各类超时参数（以go-redis为例）：

   redis.NewClient(&redis.Options{
       Addr:         "你的Redis地址",
       DialTimeout:  5 * time.Second,  // 连接超时
       ReadTimeout:  3 * time.Second,  // 读操作超时
       WriteTimeout: 3 * time.Second,  // 写操作超时
       PoolSize:     15,               // 连接池大小，根据并发量调整
   })
   

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