Redis CLIENT NO-EVICT 如何保护关键连接不被淘汰

Redis 连接很多时，真正可能被回收的并不只是键。客户端的查询缓冲区、输出缓冲区和其他中间缓冲区也会占用内存；启用 maxmemory-clients 后，Redis 会优先断开占用较多内存的客户端。要给监控、控制面或故障恢复连接留一条通道，可以在该连接本身执行 CLIENT NO-EVICT ON。成功返回 OK，表示这个连接被排除在客户端淘汰候选之外。

官方文档：https://redis.io/docs/latest/commands/client-no-evict/

先分清客户端淘汰和键淘汰

maxmemory-policy 处理的是数据键，例如 allkeys-lru 或 volatile-lru；maxmemory-clients 处理的是所有客户端连接消耗的聚合内存。后者统计查询缓冲区、输出缓冲区及中间缓冲区，超过阈值后会断开最占内存的一小部分连接，直到回到阈值以下。

在同一个关键长连接上执行 ON

这个命令的作用对象是“当前连接”，不是按用户名、连接池或客户端名称批量设置。因此不要把它当作一次全局开关，也不要在一个临时 redis-cli 连接上开启后，就以为应用连接池里的其他连接也获得保护。

# 进入需要长期保留的监控或控制面连接
redis-cli
# 在这个连接内开启客户端淘汰保护
CLIENT NO-EVICT ON
# 成功时返回 OK；保护状态只属于当前连接
# 任务结束或准备让它参与淘汰时，可执行：
CLIENT NO-EVICT OFF

Redis 官方文档标注该命令从 Redis Open Source 7.0.0 开始提供，时间复杂度为 O(1)。如果返回参数错误，优先检查服务端版本和命令拼写；如果返回权限错误，则检查执行该管理命令所需的 ACL 权限。

把 maxmemory-clients 和连接初始化配成一套

只执行 CLIENT NO-EVICT ON 而不设置客户端内存阈值，通常看不到客户端淘汰行为；只设置阈值而不保护控制连接，压力上来时又可能把排障通道断掉。生产环境应先估算业务连接的正常缓冲区，再留下明确的控制面连接。

5% 只是官方客户端管理文档给出的起步示例，不是所有实例的固定答案。连接内存来自查询和输出缓冲区，发布订阅、大批量结果和慢消费客户端都可能明显放大它；阈值应通过运行指标和容量预算调整。

保护开启后仍要检查四个断点

1. 版本与权限：确认服务端至少为 Redis 7.0，并确认账号允许执行 CLIENT NO-EVICT。
2. 连接是否真的复用：在连接池中应把开启保护的连接作为独立控制通道管理，不能每次借出后换成另一条普通连接。
3. 输出缓冲区限制：NO-EVICT 只绕过客户端淘汰，输出缓冲区硬限制、查询缓冲区极限和网络断开仍然存在。
4. 连接数量：只保护少量承担监控、切换和恢复职责的连接；保护过多会把阈值压力转移到未保护连接，并削弱内存上限的安全意义。

排查时可以先用 CLIENT LIST 查看连接地址、名称、空闲时间、输出内存和最后命令，再结合 INFO memory 与应用侧连接池指标判断是连接数增长、输出积压还是键空间占用。注意，CLIENT LIST 能帮助定位连接，但不要把普通客户端列表字段误当成 NO-EVICT 状态回读接口。

常见问题

CLIENT NO-EVICT 会阻止 Redis 删除键吗？

不会。它只排除当前连接的客户端淘汰；键是否淘汰仍由 maxmemory-policy 和键的过期属性决定。

maxmemory-clients 为 0 还需要执行 ON 吗？

可以执行，但在客户端淘汰关闭时没有可观察的淘汰保护效果。真正启用阈值后，ON 才会改变当前连接是否属于候选集合。

主从连接也需要 NO-EVICT 吗？

官方客户端管理文档说明主连接和副本连接不受客户端淘汰机制影响；普通监控连接则应按控制面通道的需要单独保护。

怎样撤销保护？

仍在该连接上执行 CLIENT NO-EVICT OFF。返回 OK 后，当前连接重新进入潜在淘汰集合。