Redis 实现数据缓存
🎯 引言
学完本文,你能缓存 MySQL 的公开用户资料,验证重复查询是否命中,并在更新资料后删除旧副本。
🧱 缓存读取流程与 Cache Aside 模式
Cache Aside,也叫旁路缓存,是应用自己决定何时读缓存、查询数据源和更新副本的方式。Redis 不会自动从 MySQL 同步数据,两者之间的读写顺序由应用代码控制。
命中指读到可用的缓存副本,回源指没有副本时再查询正式数据源。
应用场景:查询频繁、允许短时间看到旧值的数据,例如公开用户资料。下面通过查询函数观察这条流程。
查询用户资料时,按下面的顺序处理:
- 先到 Redis 查找这个用户的缓存。
- 如果有缓存,直接返回缓存中的资料,不再查询 MySQL。
- 如果没有缓存,就查询 MySQL。
- 查到用户后,将资料存入 Redis 并设置过期时间,再返回资料;没有查到则返回空结果。
本文先实现 Redis 正常时的基本流程,下一篇再加入空值缓存和故障保护。
🛠 使用 Node.js 缓存数据库查询结果
使用 Node.js 22.9.0、redis 5.9.0、mysql2 3.11.5、Redis 7.4.2。先完成 MySQL 的 Node.js 接入,准备其中的 .env、db.mjs 和 blog_demo.user 表,保留编号为 1 的练习用户。
在当前 Redis 练习目录安装数据库驱动,并复制上述两个配置文件;db.mjs 导出 pool,负责复用数据库连接:
npm install --save-exact mysql2@3.11.5
SQL 与连接池用法沿用 MySQL 课程,这里只增加缓存。新建 user-repository.mjs,记录实际读取次数:
import { pool } from './db.mjs';
export const metrics = { sourceReads: 0 };
export async function findUser(id) {
metrics.sourceReads += 1;
const [rows] = await pool.execute('SELECT id, username AS name FROM user WHERE id = ?', [id]);
return rows[0] ?? null;
}
返回公开的编号和姓名;查不到返回 null。sourceReads 只用于本地观察,正式服务应接入监控。
在 user-cache.mjs 集中定义 Key:
import { redis } from './redis.mjs';
import { findUser } from './user-repository.mjs';
export const userKey = id => `course:cache:user:v1:${id}`;
先实现“查询数据库并保存副本”:
async function loadUser(id) {
const user = await findUser(id);
if (user !== null) {
await redis.set(userKey(id), JSON.stringify(user), { EX: 60 });
}
return user;
}
只缓存实际查到的用户;60 秒是练习值,实际应按允许看到旧资料的时间选择。
再连接缓存读取与数据库读取:
export async function getUser(id) {
const raw = await redis.get(userKey(id));
return raw === null ? loadUser(id) : JSON.parse(raw);
}
命中时不会调用 findUser。这里先假设 JSON 由当前程序正确写入,损坏内容的处理在下一篇补齐。
新建 cache-demo.mjs,从空缓存开始验证:
import { redis } from './redis.mjs';
import { pool } from './db.mjs';
import { getUser, userKey } from './user-cache.mjs';
import { metrics } from './user-repository.mjs';
await redis.connect();
await redis.del(userKey(1));
连续读取两次:
console.log(await getUser(1));
console.log(await getUser(1));
console.log('数据库读取次数:', metrics.sourceReads);
两次返回同一份资料,读取次数为 1。只有观察到数据库读取减少,才能证明这个实验命中了缓存。
收尾并运行:
await redis.close();
await pool.end();
node --env-file=.env cache-demo.mjs
.env 中需要配置 MySQL 课程的 DB_HOST、DB_PORT、DB_USER、DB_PASSWORD 和 DB_NAME;不要把实际凭据提交到仓库。
🪤 缓存更新与 MySQL 数据一致性
缓存一致性关注的是:Redis 副本与数据库中的正式数据是否相符。数据库修改后,旧副本不会自动改变,继续读取它就会得到旧值。
应用场景:修改已缓存的用户资料后,需要让后续查询重新取得新资料。常用顺序是:先提交 MySQL 修改,再删除 Redis 副本。新建 update-user.mjs,先准备依赖:
import { pool } from './db.mjs';
import { redis } from './redis.mjs';
import { userKey } from './user-cache.mjs';
修改数据后,单独处理删除缓存的结果:
export async function updateUser(id, name) {
await pool.execute('UPDATE user SET username = ? WHERE id = ?', [name, id]);
try {
await redis.del(userKey(id));
return { cacheInvalidated: true };
} catch (error) {
console.error('资料已更新,但缓存失效失败:', error.message);
return { cacheInvalidated: false };
}
}
本例修改已存在的用户。单条 UPDATE 使用自动提交;换成多条数据库事务时,应在 commit 成功后再删除缓存。删除失败不能误报成“MySQL 没有更新”,实际接口可把失效状态保留在服务端日志。
这里仅缓存用户详情。如果同一记录还出现在列表等缓存中,更新时也要处理这些关联副本。
创建 update-demo.mjs,观察先有副本、更新后没有副本、再读到新值的过程:
import { redis } from './redis.mjs';
import { pool } from './db.mjs';
import { getUser, userKey } from './user-cache.mjs';
import { updateUser } from './update-user.mjs';
await redis.connect();
await getUser(1);
执行修改并检查失效:
console.log(await updateUser(1, '小林'));
console.log(await redis.exists(userKey(1)));
console.log(await getUser(1));
Redis 正常时依次看到 cacheInvalidated: true、0,以及姓名为小林的资料。
await redis.close();
await pool.end();
node --env-file=.env update-demo.mjs
这个顺序仍不保证所有并发请求立即看到新值:读取请求可能先取得旧数据,更新请求随后提交并删缓存,之前的读取最后又把旧数据写回。强一致要求读取反映已经完成的更新,普通旁路缓存没有这个保证。
能接受短暂旧值的场景,可结合 TTL、失败告警与可靠重试;要求更严格时,需要数据版本或读写协调方案。不要把“延迟再删一次”当成一致性保证。
❓ 知识问答
Q1:可以每次先查 MySQL,再写 Redis 吗?
可以保存副本,但这样没有减少数据库查询,不能实现本文的缓存读取目标。
Q2:删除缓存失败后,马上把 MySQL 改回去可以吗?
不能把它当成通用方案。数据库可能已经被其他请求使用或再次更新,应保留已提交结果并处理副本失效问题。
Q3:缓存所有数据库字段省事吗?
只缓存接口允许公开且确实需要的字段,避免把密码摘要等内部信息混进公开资料副本。
🧪 小练习
先缓存用户 1,再修改姓名并读取。记录缓存存在状态和数据库读取次数,解释每次变化的原因。
// 请在这里编写代码
🎉 恭喜你已经掌握数据库查询缓存与更新失效的基本流程啦!
