Redis 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:
import { redis } from './redis.mjs';
await redis.connect();
const key = 'course:keys:user:42';
await redis.set(key, 'Lin');
本次实验只操作 course:keys:* 前缀,便于确认清理范围。
🛠 Key 的存在判断、删除与遍历
存在判断用于确认键是否还在,类型检查用于选择相应的读写命令,遍历用于查找符合条件的一批键,删除则使指定数据立即不再可用。
这些操作常用于排查数据、清理练习键或让旧缓存失效。先检查 Key 是否存在,以及使用什么类型:
console.log(await redis.exists(key));
console.log(await redis.type(key));
依次输出 1 和 string;不存在时分别返回 0 和 none。
需要查看一类键时分批扫描:
for await (const keys of redis.scanIterator({ MATCH: 'course:keys:*', COUNT: 100 })) {
console.log(keys);
}
redis 5.9.0 每次迭代返回一批键名。MATCH 筛选前缀,COUNT 是每次扫描工作量的提示,不保证每批正好 100 个。扫描不是一致性快照,期间变化的键可能重复出现或不出现;不能把它当成精确分页。
删除已知键后再检查:
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 秒期限,写入和设置期限在一条命令中完成:
await redis.set(key, 'Lin', { EX: 60 });
console.log(await redis.ttl(key));
输出接近 60 的整数。需要毫秒期限时,使用 PX 代替 EX。
| TTL 返回值 | 含义 |
|---|---|
| 非负整数 | 剩余秒数,临近到期可能为 0 |
-1 | 键存在但没有期限 |
-2 | 键不存在 |
对已经存在的键调整期限:
console.log(await redis.expire(key, 120));
console.log(await redis.ttl(key));
依次输出 1 和接近 120 的数。expire 在键不存在时返回 0。普通读取不会续期;普通 set 覆盖值会清除旧期限,因此更新缓存时仍要明确传入 EX。
⚙️ 过期删除机制:惰性删除与定期删除
Redis 在访问 Key 时检查是否过期,过期就按不存在处理,这叫惰性删除。它也会周期性抽查带期限的 Key,清理已过期数据,这叫定期删除。
因此,到期后数据不能再被正常读取,但内存占用不一定在同一瞬间下降。排查内存时,需要区分“键已失效”和“内存已释放”。
这些机制的详细边界可查阅 EXPIRE 官方说明。
验证过期后的读取结果:
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,表明到期后普通读取已将这个键视为不存在。
最后关闭连接并运行:
await redis.close();
node keys.mjs
❓ 知识问答
Q1:设置 60 秒就一定保留满 60 秒吗?
不一定。应用可以主动删除它,内存淘汰也可能提前移除它。
Q2:删除 Redis Key 会同时删除 MySQL 记录吗?
不会。两者是独立系统,缓存过期和删除不会自动修改正式记录。
Q3:扫描结果可以用来实时统计精确数量吗?
不能保证。扫描期间数据会变化,也可能返回重复键;需要精确业务计数时应单独维护计数逻辑。
🧪 小练习
为用户资料的中文和英文版本分别设计 Key,设置不同期限,验证两份结果不会覆盖。
// 请在这里编写代码
🎉 恭喜你已经掌握 Key 命名、检查和生命周期管理啦!
