跳到主要内容
锦木信息 JINMU INFO
Redis 博客
Redis · 连接管理

别让连接拖垮它

连接池、maxclients、输出缓冲与重连风暴

Redis 处理命令快如闪电,却常常栽在连接上:每个请求新建一条连接、重连风暴、慢订阅者把内存撑爆……这些都和命令本身无关。学会复用连接、设好上限、看懂缓冲,是稳定运行的隐形功课。

▲ 短连接:每次握手新建又关闭;连接池:固定几条,反复复用pool vs churn
✗ 短连接:每个请求都 connect→AUTH→命令→close 握手+AUTH1条命令 握手+AUTH1条命令 握手+AUTH1条命令 大量开销全花在建连上… ✓ 连接池:少量长连接,借出→用→还回,反复复用 连接池 c1 c2 c3 c4 Redis 同一批连接一直用,省掉反复握手/认证的开销
01 · 建连的代价

每条连接都不是免费的

很多人以为"Redis 这么快,连接随开随关没关系"。错。建立一条连接要走 TCP 三次握手,可能还要 TLS 协商和 AUTH 认证;而且每条连接在服务端都占用一个文件描述符和一块内存(查询缓冲 + 输出缓冲)。请求量一大,光是"建连 + 拆连"的开销就能压过命令本身。

打个比方

像每次打电话都重新拨号、重新报暗号确认身份,只为说一句话就挂断。真正高效的做法是:接通几条专线一直开着,有话就借一条说,说完归还——这就是连接池。

02 · 连接池

借出,用完,还回

连接池在应用启动时预先建好少量长连接,放在池子里。每次要操作 Redis,就从池里借一条,用完还回去给别人复用,而不是新建。几乎所有客户端库(Jedis、Lettuce、redis-py、go-redis…)都内置了连接池。

参数(以常见库为例)含义
max-total / pool-size池子最多几条连接——决定并发上限
max-idle / min-idle空闲连接的上/下限,避免频繁创建销毁
max-wait池子满时,借连接最多等多久(别设成无限等)
test-on-borrow / keepalive借出前探活,避免拿到已断的死连接
i

池子大小不是越大越好。连接数 ≈ 并发请求数即可:Redis 命令是微秒级的,一条连接一秒能跑很多次。几十到几百条通常够用,成千上万条反而徒增 Redis 的内存与调度负担。按压测的实际并发来定,别拍脑袋。

03 · 上限

maxclients 与那条著名的报错

Redis 用 maxclients 限制同时连接数,默认 10000。一旦连满,新连接会收到那句经典报错——ERR max number of clients reached,然后被立刻关闭。

ERR max number of clients reached CONFIG GET maxclients # 看上限 INFO clients # connected_clients / blocked_clients / maxclients CONFIG SET maxclients 20000 # 调大(还需同步调高 OS 的文件描述符上限)
!

两个关键细节:① Redis 会给内部预留 32 个文件描述符,并受操作系统 ulimit 约束——若 OS 的 fd 上限不够,Redis 会自动下调实际 maxclients,启动日志里会写明。调大 maxclients 必须同时调高 OS 的 fd 上限。② 连满了往往不是真需要这么多连接,而是:没用连接池、连接泄漏(借了不还)、或重连风暴。先查根因,别急着调大。

04 · 输出缓冲

慢客户端能把内存撑爆

Redis 给每条连接准备了一块输出缓冲,暂存要发给客户端的响应。如果客户端读得比 Redis 写得慢(网络慢、或订阅了高频频道却处理不过来),缓冲就会越堆越大——这些内存还算进 maxmemory。为防失控,Redis 按客户端类型设了上限 client-output-buffer-limit:

客户端类型硬限 / 软限 / 软窗口说明
normal0 / 0(不限)普通客户端一般发一条读一条,不易堆积
pubsub32MB / 8MB / 60s订阅者处理不过来,超限即被断开
replica256MB / 64MB / 60s副本跟不上主库复制流时的保护阈值

硬限:一到立即断开。软限:持续超过该值并维持够久(软窗口秒数)才断开。被断开的慢订阅者/慢副本会触发重连——这也是排查"莫名其妙断连"的一个常见方向。

05 · CLIENT 命令族

看清、命名、踢掉连接

排查连接问题,CLIENT 命令族是你的眼睛和手:

CLIENT LIST # 列出每条连接:addr/age/idle/flags/cmd/omem(输出缓冲)… CLIENT INFO # 只看当前这条连接(6.2+) CLIENT SETNAME worker-a # 给连接起名,之后出现在 LIST 和 SLOWLOG 里,便于定位 CLIENT KILL ADDR 10.0.0.9:52555 # 踢掉某条连接(也可按 ID/TYPE 等过滤) CLIENT NO-EVICT on # 让监控/控制连接免于被客户端驱逐(7.0+) CLIENT NO-TOUCH on # 本连接的命令不更新 key 的 LRU/LFU,避免监控流量干扰驱逐(7.2+)

用 CLIENT LIST 看哪条连接 omem(输出缓冲)异常大、idle 很久、或某个 cmd 可疑;给每类连接 SETNAME 后,排查时一眼就能认出"是哪个服务开的"。

06 · 实践要点

连接这块,做对这几件

✓ 该做
  • 用连接池,池大小按实际并发定,配好探活
  • 开 TCP keepalive(默认约 300s)清理死连接
  • 设 maxmemory-clients(如 5%)启用客户端驱逐,防缓冲吃爆内存(7.0+)
  • 给连接 SETNAME,监控 INFO clients 的 connected_clients
✗ 别做
  • 每个请求新建+关闭连接(短连接)
  • 借了连接不归还(连接泄漏),慢慢耗尽池子
  • 一遇 maxclients 报错就盲目调大,不查根因
  • 把 timeout 设得过短,误杀正常的长连接
!

一个最凶的场景——重连风暴:Redis 短暂抖动或主从切换时,成千上万客户端同时断开又同时重连,握手+认证的洪峰可能把刚恢复的实例再次压垮。对策:客户端重连要带指数退避 + 随机抖动,别让大家卡着同一秒一起冲。

收尾 · 一句话

命令很快,连接要省着用

Redis 的性能常常不是败在命令,而是败在连接:短连接的握手开销、泄漏耗尽的池子、慢客户端撑爆的输出缓冲、重连风暴的洪峰。复用连接(池)、设好上限(maxclients + OS fd)、看懂缓冲(CLIENT LIST / 输出缓冲限额)、重连带退避——这几件做对,连接就不会成为那块短板。

连接池复用(大小≈并发)· maxclients 默认 10000(受 OS fd 约束,调大需同调 ulimit)· client-output-buffer-limit:pubsub 32/8MB、replica 256/64MB · CLIENT LIST/KILL/SETNAME/NO-EVICT · maxmemory-clients 5%(7.0+) · 重连要指数退避+抖动防风暴

聊聊您的数据难题

告诉我们业务现状,资深技术顾问一对一给出选型与实施建议,咨询免费。