直接删大Key会卡住Redis主线程,Spring Boot中redisTemplate.delete()底层调用同步DEL命令,高危;应改用原生连接执行UNLINK实现异步删除,并配合SCAN分批处理前缀key,同时确保序列化器匹配、控制速率并监控lazyfree_pending_objects等指标。

直接删大Key会卡住Redis主线程,Spring Boot里用redisTemplate.delete()看似简单,实则高危——它底层发的是同步DEL命令,不管key多大,都得等内存释放完才返回。
UNLINK比DEL更安全,但Spring Data Redis默认不支持
Redis 4.0+ 的UNLINK命令才是处理大Key的正确姿势:先解绑key,再异步回收内存。但RedisTemplate的delete()方法只调DEL,不走UNLINK。
- 必须绕过
RedisTemplate,用原生连接执行:redisTemplate.getConnectionFactory().getConnection().unlink(...) -
unlink()接收byte[]或Collection<byte></byte>,传字符串key前得用StringRedisSerializer序列化 - 注意:
UNLINK对小对象(如短字符串)仍可能同步释放,别以为加了就万事大吉 - Spring Boot 3.2+ 的
RedisTemplate仍未内置unlink()快捷方法,得自己封装
批量删前缀key时,KEYS会阻塞,SCAN才是生产级方案
写redisTemplate.keys("user:*")在测试环境跑得欢,上线后可能让Redis“假死”——KEYS是全库扫描,O(N)复杂度,数据量一过百万就明显拖慢。
- 改用
SCAN游标分批:调connection.scan(ScanOptions.scanOptions().match("user:*").count(100).build()) - 每次最多取100个key,删完再扫下一批,避免单次操作耗时过长
- 别把所有key攒到一个
Set里再delete(),内存和网络压力双高 - SCAN不保证一次扫完,要循环直到游标返回"0",且需自己去重(SCAN可能重复返回)
序列化器不匹配,keys()永远返回空
明明Redis里有user:123,但redisTemplate.keys("user:*")就是查不到——八成是keySerializer没设对。
- 默认用
JdkSerializationRedisSerializer,key实际存成\xac\xed\x00\x05t\x00\x07user:123,KEYS user:*当然匹配不上 - 必须显式配置:
template.setKeySerializer(new StringRedisSerializer()) - 如果业务混用
StringRedisTemplate和RedisTemplate,它们序列化方式不同,同一个key可能存两份、删不干净 - 验证方法:用
redis-cli连上去执行KEYS user:*,看是否能查到;若能,说明Java端序列化有问题
异步删除不是零成本,后台积压会导致内存延迟下降
开了UNLINK或配置了lazyfree-lazy-eviction yes,不代表内存立刻腾出来。Redis后台线程回收有队列,积压严重时,INFO memory里的mem_used_human降得慢,甚至触发OOMKiller。
- 监控关键指标:
lazyfree_pending_objects(待回收对象数)、used_memory_rss(进程实际驻留内存) - 别一口气
UNLINK上万个大key,按批次提交,每批间隔几十毫秒 - 删完观察P99延迟是否飙升,副本同步延迟是否拉长——后台回收吃CPU,会影响主从复制
- 内存分配器(如jemalloc)可能缓存页,
used_memory下降滞后是正常现象,但used_memory_rss长期不降就得查回收是否卡住
真正麻烦的不是“怎么删”,而是删之前没确认key类型和大小、删的时候没控速、删完没盯指标。UNLINK和SCAN只是工具,节奏感和可观测性才是安全底线。


















