Redis 与缓存 / 系统课时
演练 maxmemory 拒写故障
演练 maxmemory 拒写故障
本课通过一个可重复的 Redis 实验制造 maxmemory 拒写,重点练习如何用配置、内存指标和失败命令组成证据链,再选择扩容、限流或数据治理作为止损动作。maxmemory 到达后是否拒写,取决于配置的淘汰策略;noeviction 会让新增数据的写命令返回 OOM 错误。:contentReference[oaicite:0]{index=0}
学习目标
- 能用
INFO memory、INFO stats和配置项确认拒写是否由maxmemory触发。 - 能区分“可淘汰但持续抖动”和“无淘汰、直接拒写”两类故障。
- 能根据证据选择扩容、限流或数据治理,并完成恢复验证。
演练场景与注入条件
实验使用专用 Redis 实例,避免把故障注入共享环境。先把 maxmemory 设得足够小,再明确使用 noeviction,这样写入达到限制后不会通过淘汰腾出空间,而是让新增数据的命令失败。:contentReference[oaicite:1]{index=1}
redis-cli -p <PORT> CONFIG SET maxmemory 2mb
redis-cli -p <PORT> CONFIG SET maxmemory-policy noeviction
redis-cli -p <PORT> SET warmup:init ok
redis-cli -p <PORT> INFO memory | grep -E 'used_memory:|maxmemory:|used_memory_dataset:'预期结果
OK
OK
OK
used_memory:<当前值>
maxmemory:2097152
used_memory_dataset:<当前值>实际 used_memory 会受 Redis 版本、启动开销和已有数据影响,因此重点不是某个固定数值,而是确认 maxmemory 已生效且剩余空间有限。

建立拒写证据链
故障出现后不要先改配置。先确认四件事:内存是否接近上限、上限是多少、淘汰策略是什么、失败是否发生在新增数据的命令。INFO stats 中的 commandstats 可帮助观察命令被拒绝的情况;错误文本通常会直接包含 OOM command not allowed when used memory > 'maxmemory'。:contentReference[oaicite:2]{index=2}
redis-cli -p <PORT> INFO memory | grep -E 'used_memory:|used_memory_dataset:|maxmemory:|mem_not_counted_for_evict:'
redis-cli -p <PORT> CONFIG GET maxmemory maxmemory-policy
redis-cli -p <PORT> SET drill:key:<ID> <VALUE>
redis-cli -p <PORT> INFO stats | grep -E 'evicted_keys:|expired_keys:'预期结果
used_memory:<接近 maxmemory>
used_memory_dataset:<接近 maxmemory>
maxmemory:2097152
mem_not_counted_for_evict:<值可能大于 0>
1) "maxmemory"
2) "2097152"
3) "maxmemory-policy"
4) "noeviction"
(error) OOM command not allowed when used memory > 'maxmemory'.
evicted_keys:0
expired_keys:<实验期间变化值>这里最关键的是拒写与淘汰不能混为一谈。noeviction 下新增数据会报错;其他策略可能通过淘汰释放空间,因此即使同样接近 maxmemory,故障表现也不同。:contentReference[oaicite:3]{index=3}
选择止损动作
先看业务是否允许丢缓存数据。若 Redis 是纯缓存、容量已经长期不足,优先评估扩容或调整淘汰策略;若当前流量是突发写入,限流可以先把增长速度压下来;若定位到异常命名空间、大 Value 或无效数据持续增长,则应在恢复服务后做数据治理。
不要把“临时把 maxmemory 调大”当成根因修复。它只是把可用空间向后推移,而且运行时通过 CONFIG SET 修改的配置不会自动写回配置文件;需要同步持久化配置,否则重启后可能恢复旧值。:contentReference[oaicite:4]{index=4}
恢复与验收
止损完成后,重新执行同一写入动作,并再次检查 used_memory、maxmemory 与拒写现象。验收重点是:业务写入恢复、内存增长速度受控、没有因为放大上限而把实例推向系统内存风险。
redis-cli -p <PORT> SET drill:key:<ID> <VALUE>
redis-cli -p <PORT> INFO memory | grep -E 'used_memory:|maxmemory:'
redis-cli -p <PORT> INFO stats | grep -E 'evicted_keys:|expired_keys:'预期结果
OK
used_memory:<低于或暂未明显超过当前安全水位>
maxmemory:<治理后的上限>
evicted_keys:<按所选策略可能增加,也可能保持不变>
expired_keys:<按 TTL 实际变化>这次演练真正要形成的习惯,是把“客户端收到 OOM”追溯到 Redis 的内存上限和策略,再结合增长趋势决定止损方式,而不是看到一条 OOM 错误就直接扩容。