Redis 客户端连接池耗尽时怎么判断是慢命令还是未归还

Redis 连接池突然耗尽时，先别急着把 PoolSize 调大。这个现象至少有三种来源：命令在 Redis 端执行得很久、请求拿到连接后迟迟没有结束，或者并发确实超过了池容量。最可靠的判断方式是把客户端等待时间、命令执行时间和 Redis 当前连接状态放在同一时间窗里对照。

先把“连接池耗尽”拆成三个时间段

一次调用可以拆为“等待连接—发送命令—等待回复—归还连接”。监控只记录总耗时，就会把池等待误报成 Redis 慢。建议在同一个请求 ID 下记录池等待、命令 RTT 和业务处理时间，并连续观察一分钟以上，而不是只看一次瞬时值。

用 PoolStats 判断池是真满还是命令占用过久

以 go-redis/v9 为例，PoolStats() 返回的是累计统计，排查时要保存两次采样的差值。Timeouts 增长说明等待连接超过了 PoolTimeout；PendingRequests 是当前正在等连接的请求数；TotalConns 接近容量而 IdleConns 长时间为零，说明连接都在使用中，但还不能单独证明“忘记归还”。

before := rdb.PoolStats()
// 业务请求结束后再次采样，用差值避免把历史累计量当成当前故障。
after := rdb.PoolStats()

fmt.Printf("pool total=%d idle=%d pending=%d timeouts=%d misses=%d\\n",
    after.TotalConns,
    after.IdleConns,
    after.PendingRequests,
    after.Timeouts-before.Timeouts,
    after.Misses-before.Misses,
)
// 若业务允许，给每条 Redis 调用设置独立 context，避免无限占用连接。
ctx, cancel := context.WithTimeout(context.Background(), 800*time.Millisecond)
defer cancel()
_, err := rdb.Get(ctx, "profile:42").Result()

判断重点是趋势：Timeouts 和 PendingRequests 同时上升，优先看池等待；IdleConns 归零但超时不增，可能只是高并发短时借用；若等待持续且业务请求也在变慢，再检查调用是否持有事务、发布订阅或阻塞命令。

用命令耗时证据排除 Redis 端慢命令

SLOWLOG GET 的执行耗时只覆盖 Redis 真正执行命令的阶段，不包含客户端与服务端之间的 I/O，也不包含客户端在池中等待。因此慢日志为空，并不能推出“连接池没有问题”；它反而提示应继续看客户端等待和网络 RTT。

# 只读取最近少量慢日志，避免在故障现场拉取过多历史记录。
redis-cli SLOWLOG GET 20

# 观察客户端连接总量、阻塞客户端和服务端上限。
redis-cli INFO clients

如果慢日志中的命令执行时间与应用总耗时同量级，先治理命令、键分布或批量大小；如果慢日志很短而应用端 Timeouts 增长，则不要把 Redis 慢命令作为第一嫌疑。

用 CLIENT LIST 找到长期占用连接的请求边界

在授权的维护窗口执行 CLIENT LIST，重点看 age、idle、flags、cmd、name。flags 中的 b 表示客户端正在阻塞调用；cmd 能提示最后一个命令。给客户端设置可区分的连接名后，才能把 Redis 连接和应用实例对应起来。

这里的“未归还”要谨慎表述：普通 go-redis 命令会由客户端内部管理连接，池满并不等于存在一个可直接手动归还的对象。更常见的是调用卡在阻塞命令、事务、订阅，或上层 goroutine 没有因为请求取消而退出。把 CLIENT LIST 的长期连接与应用请求日志、超时堆栈按时间对齐，才算定位证据。

修复顺序：先结束占用，再调整容量

修复后至少同时看四项：应用端命令 P95、池等待 P95、Timeouts 增量、IdleConns 是否恢复波动。只有这些指标在相同流量下恢复，调大容量才有意义。

相关问题

PoolStats 的 Timeouts 一直是历史大数怎么办？

它是累计计数，使用相邻采样差值或按实例重启/进程启动时间切分，不要把绝对值当作当前每秒超时。

慢日志为空就能排除慢命令吗？

不能。它不包含客户端排队、网络传输和回复读取时间；要把慢日志耗时与应用端命令 RTT 对照。

什么时候可以增加 PoolSize？

当请求已设置边界、没有长期占用者，Redis CPU、连接上限和网络仍有余量，且池等待在稳定流量下持续存在时，再小步调大并观察。

参考：Redis 客户端文档、INFO、SLOWLOG GET、CLIENT LIST、go-redis PoolStats 字段说明。