Redis 与缓存 / 知识点

Redis 开发常用命令速查

字符串与缓存生命周期

CODE
UNLINK key [key ...]

从键空间摘除键并将内存回收主要交给后台线程,适合清理大键降低阻塞风险;它同样是不可逆的删除操作,必须核实范围。

异步释放指定键

需要删除大型 Hash、List、Set、Sorted Set 等键,同时尽量减少内存回收对 Redis 主线程的阻塞时,使用 UNLINK。命令会先从键空间摘除目标键,使其立即无法被正常读取,再将主要内存回收工作交给后台线程处理。删除不可撤销,且内存占用不保证立即下降。

基本语法

text
UNLINK key [key ...]
  • key:要删除的键名,至少指定一个,可以同时指定多个。
  • [key ...]:可选的其他键名,使用空格分隔。
  • 返回值:整数,表示实际从键空间删除的键数量。
  • 不存在的键会被忽略,不计入返回值,也不会因此报错。

例如同时指定三个键,其中只有两个存在,成功执行后返回 2。如果所有目标键均不存在,则返回 0。

UNLINK 不支持通过 *、? 等通配符直接匹配键名。传入的参数是具体键名,而不是自动展开的键模式。

可验证示例

前置条件:Redis 服务正在运行,已安装 redis-cli,并且当前终端可以连接到测试实例。以下使用 Bash 和默认连接参数,使用带当前 Shell 进程号的临时键,避免直接操作业务数据。

bash
# 使用进程号构造演示键,降低与现有键冲突的可能性
key="anystack:unlink:demo:$$"

# NX 防止覆盖已有键;创建失败时不执行删除
if [ "$(redis-cli --raw SET "$key" temporary NX)" = "OK" ]; then
  redis-cli --raw UNLINK "$key"
  redis-cli --raw EXISTS "$key"
  redis-cli --raw UNLINK "$key"
else
  echo '演示键创建失败,已跳过删除'
fi

首次创建成功且后续命令正常执行时,预期输出:

text
1
0
0

三个数字依次表示:

  1. UNLINK 返回 1,说明一个存在的键已被删除。
  2. EXISTS 返回 0,说明该键已经不在键空间中。
  3. 再次执行 UNLINK 返回 0,说明不存在的键不会重复计数。

如果显示“演示键创建失败,已跳过删除”,应检查 Redis 连接、权限或键名冲突,不应绕过创建检查直接执行删除。

返回结果与内存回收

UNLINK 的执行结果需要区分两个阶段:键空间中的删除完成,以及相关内存的实际释放完成。

  • 键空间删除:命令成功返回后,目标键对后续正常读取已不可见,EXISTS 返回 0。
  • 内存回收:对象主要通过后台机制释放;即使 UNLINK 已返回成功,内存指标也可能暂时没有明显变化。
  • 复杂度:从键空间摘除每个键的操作为 O(1);后台回收仍需要与对象内部内存分配数量相关的工作量。

可以通过 INFO memory 观察 used_memory 和 lazyfree_pending_objects 等指标。后者表示等待异步释放的对象数量,但小对象或已经完成的回收任务可能不会形成明显积压。

不要只根据操作系统显示的 RSS 是否立即下降判断删除是否成功。Redis 释放对象后,内存分配器也不一定立即把物理内存归还操作系统。

风险与恢复

执行生产环境删除前,应完成以下检查:

  1. 确认 Redis 实例、数据库和目标键名,避免连接到错误环境。
  2. 使用 EXISTS 判断键是否存在,必要时通过 TYPE、TTL 和 MEMORY USAGE 检查键的类型、剩余有效期与内存占用。
  3. 核实目标键是否仍被业务使用,尤其是会话、订单状态、锁和任务队列相关数据。
  4. 批量删除前先明确生成的键名清单,抽样核对,再控制每批操作数量。
  5. 确认存在可用的备份或业务数据重建手段后,再执行不可逆删除。

Redis Cluster 中,多键 UNLINK 通常要求目标键位于同一哈希槽,否则可能返回 CROSSSLOT 错误。对于不同哈希槽的键,应按槽分组执行或逐键删除,不能假定一次命令可以跨节点删除全部目标。

如果误删,只能依据可用的备份、业务源数据或应用重建机制恢复;Redis 不提供对应的 UNLINK 撤销命令。

UNLINK 自 Redis Open Source 4.0.0 起可用。需要清理大键时优先考虑它,但大量删除操作仍需分批控制,避免后台回收任务积压或给业务带来集中缓存失效压力。

对象字段读写

列表与简单队列

去重与集合运算

目录与阅读设置

记录一个想法

Redis 开发常用命令速查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通