Redis 实现数据缓存

在 Node.js 中缓存数据库查询结果,并处理缓存更新与 MySQL 数据一致性。

🎯 引言

学完本文,你能缓存 MySQL 的公开用户资料,验证重复查询是否命中,并在更新资料后删除旧副本。


🧱 缓存读取流程与 Cache Aside 模式

Cache Aside,也叫旁路缓存,是应用自己决定何时读缓存、查询数据源和更新副本的方式。Redis 不会自动从 MySQL 同步数据,两者之间的读写顺序由应用代码控制。

命中指读到可用的缓存副本,回源指没有副本时再查询正式数据源。

应用场景:查询频繁、允许短时间看到旧值的数据,例如公开用户资料。下面通过查询函数观察这条流程。

查询用户资料时,按下面的顺序处理:

  1. 先到 Redis 查找这个用户的缓存。
  2. 如果有缓存,直接返回缓存中的资料,不再查询 MySQL。
  3. 如果没有缓存,就查询 MySQL。
  4. 查到用户后,将资料存入 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,记录实际读取次数:

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:

user-cache.mjs
import { redis } from './redis.mjs';
import { findUser } from './user-repository.mjs';

export const userKey = id => `course:cache:user:v1:${id}`;

先实现“查询数据库并保存副本”:

user-cache.mjs
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 秒是练习值,实际应按允许看到旧资料的时间选择。

再连接缓存读取与数据库读取:

user-cache.mjs
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,从空缓存开始验证:

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));

连续读取两次:

cache-demo.mjs
console.log(await getUser(1));
console.log(await getUser(1));
console.log('数据库读取次数:', metrics.sourceReads);

两次返回同一份资料,读取次数为 1。只有观察到数据库读取减少,才能证明这个实验命中了缓存。

收尾并运行:

cache-demo.mjs
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,先准备依赖:

update-user.mjs
import { pool } from './db.mjs';
import { redis } from './redis.mjs';
import { userKey } from './user-cache.mjs';

修改数据后,单独处理删除缓存的结果:

update-user.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,观察先有副本、更新后没有副本、再读到新值的过程:

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);

执行修改并检查失效:

update-demo.mjs
console.log(await updateUser(1, '小林'));
console.log(await redis.exists(userKey(1)));
console.log(await getUser(1));

Redis 正常时依次看到 cacheInvalidated: true、0,以及姓名为小林的资料。

update-demo.mjs
await redis.close();
await pool.end();
node --env-file=.env update-demo.mjs

这个顺序仍不保证所有并发请求立即看到新值:读取请求可能先取得旧数据,更新请求随后提交并删缓存,之前的读取最后又把旧数据写回。强一致要求读取反映已经完成的更新,普通旁路缓存没有这个保证。

能接受短暂旧值的场景,可结合 TTL、失败告警与可靠重试;要求更严格时,需要数据版本或读写协调方案。不要把“延迟再删一次”当成一致性保证。


❓ 知识问答

Q1:可以每次先查 MySQL,再写 Redis 吗?

可以保存副本,但这样没有减少数据库查询,不能实现本文的缓存读取目标。

Q2:删除缓存失败后,马上把 MySQL 改回去可以吗?

不能把它当成通用方案。数据库可能已经被其他请求使用或再次更新,应保留已提交结果并处理副本失效问题。

Q3:缓存所有数据库字段省事吗?

只缓存接口允许公开且确实需要的字段,避免把密码摘要等内部信息混进公开资料副本。


🧪 小练习

先缓存用户 1,再修改姓名并读取。记录缓存存在状态和数据库读取次数,解释每次变化的原因。

// 请在这里编写代码

🎉 恭喜你已经掌握数据库查询缓存与更新失效的基本流程啦!