Redis Key 管理与过期时间

设计 Redis Key,设置与检查过期时间,并通过 Node.js 管理 Key 的生命周期。

🎯 引言

学完本文,你能为不同查询设计不会串用的 Key,检查剩余有效期,并安全遍历和删除练习数据。


🧱 Key 命名规范与常见命令

Key 命名需要区分所属应用和数据用途,避免不同模块使用同名 Key 覆盖彼此的数据。

应用场景:多个模块共用 Redis 时,可以用前缀避免覆盖彼此的数据。例如 course:dev:user:v1:42 依次表示项目、环境、数据主题、格式版本和用户编号。冒号是命名约定,不会创建目录。

如果同一资料按语言返回不同结果,语言也要进入 Key;私有资料还需区分可信用户身份。v1 用于区分数据结构版本,不会自动随数据库内容更新。

本篇使用 Node.js 22.9.0、redis 5.9.0、Redis 7.4.2,复用入门篇的 redis.mjs。以下代码依次写入 keys.mjs:

keys.mjs
import { redis } from './redis.mjs';

await redis.connect();
const key = 'course:keys:user:42';
await redis.set(key, 'Lin');

本次实验只操作 course:keys:* 前缀,便于确认清理范围。


🛠 Key 的存在判断、删除与遍历

存在判断用于确认键是否还在,类型检查用于选择相应的读写命令,遍历用于查找符合条件的一批键,删除则使指定数据立即不再可用。

这些操作常用于排查数据、清理练习键或让旧缓存失效。先检查 Key 是否存在,以及使用什么类型:

keys.mjs
console.log(await redis.exists(key));
console.log(await redis.type(key));

依次输出 1 和 string;不存在时分别返回 0 和 none。

需要查看一类键时分批扫描:

keys.mjs
for await (const keys of redis.scanIterator({ MATCH: 'course:keys:*', COUNT: 100 })) {
    console.log(keys);
}

redis 5.9.0 每次迭代返回一批键名。MATCH 筛选前缀,COUNT 是每次扫描工作量的提示,不保证每批正好 100 个。扫描不是一致性快照,期间变化的键可能重复出现或不出现;不能把它当成精确分页。

删除已知键后再检查:

keys.mjs
console.log(await redis.del(key));
console.log(await redis.exists(key));

输出 1 和 0。del 返回删除数量,重复删除返回 0。避免在生产大库执行一次性遍历全部键的 KEYS *;大值删除可用 UNLINK 将主要内存释放工作放到后台。


🧰 EXPIRE、TTL 与 SET EX

过期时间规定 Key 可以保留到什么时候,到期后读取会按不存在处理。EXPIRE 为已有 Key 设置有效秒数,TTL 查询剩余秒数,SET 的 EX 选项在写入时同时设置期限。

应用场景:临时验证码、短期会话和缓存副本都需要控制有效时间。下面演示设置 60 秒期限,写入和设置期限在一条命令中完成:

keys.mjs
await redis.set(key, 'Lin', { EX: 60 });
console.log(await redis.ttl(key));

输出接近 60 的整数。需要毫秒期限时,使用 PX 代替 EX。

TTL 返回值含义
非负整数剩余秒数,临近到期可能为 0
-1键存在但没有期限
-2键不存在

对已经存在的键调整期限:

keys.mjs
console.log(await redis.expire(key, 120));
console.log(await redis.ttl(key));

依次输出 1 和接近 120 的数。expire 在键不存在时返回 0。普通读取不会续期;普通 set 覆盖值会清除旧期限,因此更新缓存时仍要明确传入 EX。


⚙️ 过期删除机制:惰性删除与定期删除

Redis 在访问 Key 时检查是否过期,过期就按不存在处理,这叫惰性删除。它也会周期性抽查带期限的 Key,清理已过期数据,这叫定期删除。

因此,到期后数据不能再被正常读取,但内存占用不一定在同一瞬间下降。排查内存时,需要区分“键已失效”和“内存已释放”。

这些机制的详细边界可查阅 EXPIRE 官方说明。

验证过期后的读取结果:

keys.mjs
await redis.set(key, 'temporary', { PX: 200 });
await new Promise(resolve => setTimeout(resolve, 300));
console.log(await redis.get(key));
console.log(await redis.ttl(key));

输出 null 和 -2,表明到期后普通读取已将这个键视为不存在。

最后关闭连接并运行:

keys.mjs
await redis.close();
node keys.mjs

❓ 知识问答

Q1:设置 60 秒就一定保留满 60 秒吗?

不一定。应用可以主动删除它,内存淘汰也可能提前移除它。

Q2:删除 Redis Key 会同时删除 MySQL 记录吗?

不会。两者是独立系统,缓存过期和删除不会自动修改正式记录。

Q3:扫描结果可以用来实时统计精确数量吗?

不能保证。扫描期间数据会变化,也可能返回重复键;需要精确业务计数时应单独维护计数逻辑。


🧪 小练习

为用户资料的中文和英文版本分别设计 Key,设置不同期限,验证两份结果不会覆盖。

// 请在这里编写代码

🎉 恭喜你已经掌握 Key 命名、检查和生命周期管理啦!