Redis 原子操作、事务与 Pipeline

理解 Redis 原子操作、事务与 Pipeline 的作用,区分操作正确性与批量执行效率。

🎯 引言

学完本文,你能使用原子自增避免丢计数,把相关修改放入事务,并用 Pipeline 减少批量操作的网络等待。


🧱 Redis 命令的原子性

原子性在这里指一条命令执行期间,不会插入其他客户端的命令。但应用连续发送的两条命令仍是两个操作,其他客户端可以在它们之间修改数据。

这一点在多个请求修改同一数据时很重要。例如两个请求各自先读到 10,再各自写回 11,就会少算一次。需要把这类修改交给 Redis 的原子命令完成。

本篇使用 Node.js 22.9.0、redis 5.9.0、Redis 7.4.2。下面各组代码按顺序写入 transactions.mjs,复用入门篇的连接:

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

await redis.connect();
const counterKey = 'course:atomic:views';
await redis.del(counterKey);

🛠 INCR 等原子操作

INCR 是整数自增命令,在 Redis 内完成读取、加一和写回,返回增加后的数值。多个客户端同时调用,也不会因为读取到相同旧值而互相覆盖。

应用场景:统计访问次数、累计操作次数。下面只观察一次增加 1 和一次增加指定数值的结果:

transactions.mjs
console.log(await redis.incr(counterKey));
console.log(await redis.incrBy(counterKey, 3));

输出 1、4。不存在的键按 0 开始;incrBy 的第二个参数是增加量。Hash 字段计数可用 hIncrBy,排名分数可用 zIncrBy,思路相同。

值必须能表示 Redis 支持的整数。对 JSON 文本执行自增会报错;自增也不会自动设置期限。


🧰 MULTI、EXEC 与 WATCH 事务

Redis 事务把一组命令先排队,再一次提交执行。提交后,这组命令的执行过程中不会插入其他客户端的命令。MULTI 开始收集命令,EXEC 提交命令组并返回各条命令的结果。

应用场景:需要让几项相关修改连续完成时,例如写入 Hash 并设置它的期限。先准备本次实验的键:

transactions.mjs
const profileKey = 'course:atomic:profile';
await redis.del(profileKey);
const transaction = redis.multi();

multi() 创建命令组。接着加入两项修改,此时还没有发送执行:

transactions.mjs
transaction.hSet(profileKey, { name: 'Lin' });
transaction.expire(profileKey, 60);

提交并观察结果:

transactions.mjs
console.log(await transaction.exec());
console.log(await redis.ttl(profileKey));

空键开始时输出 [1, 1],分别表示新增一个字段、期限设置成功;TTL 接近 60。

Redis 事务不提供数据库式回滚。执行阶段某条命令发生类型错误,其他合法命令仍可能执行;不能把事务失败理解为所有数据保持原样。

WATCH 会监视指定 Key 是否发生变化。如果从开始监视到提交事务之间发生修改,本次事务就不执行。它不会锁住数据,其他客户端仍然可以修改被监视的键。

应用场景:先读取旧值、在程序中计算新值,再提交修改时,用它防止覆盖期间发生的其他更新。

在同一脚本中创建一条专用连接,防止 WATCH 状态与其他请求混在一起:

transactions.mjs
import { WatchError } from 'redis';

const watched = redis.duplicate();
watched.on('error', error => console.error(error.message));
await watched.connect();
await redis.set('course:atomic:label', 'A');

监听 Key,读取旧值,再模拟另一个连接修改它:

transactions.mjs
await watched.watch('course:atomic:label');
const label = await watched.get('course:atomic:label');
await redis.set('course:atomic:label', 'B');

尝试提交基于旧值生成的结果:

transactions.mjs
try {
    await watched.multi().set('course:atomic:label', `${label}!`).exec();
} catch (error) {
    if (!(error instanceof WatchError)) throw error;
    console.log('资料已改变,本次修改未提交');
} finally {
    await watched.close();
}

打印冲突提示,Key 仍为 B。实际业务可重新读取后有限次重试,或返回冲突。WATCH 按连接保存状态,HTTP 并发请求应使用独占连接或连接池,不能在一条共享连接上交叉执行 WATCH 流程。参见 node-redis 事务文档。


⚡ Pipeline 批量执行与性能作用

Pipeline 是批量发送命令、随后接收各条结果的方式。客户端不必每发送一条就等待一次回复,因此能减少连续操作中的网络等待。它没有事务的连续执行保证。

应用场景:批量读取多个独立键,或一次写入多份互不依赖的数据。下面把两次写入一起发送:

transactions.mjs
const pipeline = redis.multi();
pipeline.set('course:atomic:a', 'A');
pipeline.set('course:atomic:b', 'B');
console.log(await pipeline.execAsPipeline());

输出 ['OK', 'OK']。虽然也用 multi() 收集命令,但 execAsPipeline() 不用 Redis 事务包裹它们。

批量大小应有限制。一次积攒大量命令会增大客户端、服务端和网络缓冲压力;Pipeline 也不会让一条耗时命令本身变快。


⚖️ Pipeline 与事务的区别

需求选择
一个值增加一次原子命令,如 INCR
固定的多条命令连续执行multi() + exec()
修改取决于之前读取的值WATCH 检查冲突,再提交事务
批量读取或写入独立结果Pipeline

在 JavaScript 中使用 Promise.all 不会获得事务保证。

关闭连接后运行:

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

❓ 知识问答

Q1:事务中的 get 结果能马上用来写 JavaScript 条件吗?

不能。排队时尚未执行命令,结果在 exec 完成后才返回。先读后改用 WATCH,服务端条件操作也可以用短 Lua 脚本。

Q2:事务可以同时提交 Redis 和 MySQL 吗?

不能。它只管理 Redis 中的命令,两个系统之间仍要设计一致性处理。

Q3:收到超时就能重放整组命令吗?

不能直接这样做。超时只说明客户端未及时拿到结果,服务端可能已经执行。重放 INCR 会再次计数,原子性不保证一次业务请求只执行一次。


🧪 小练习

用事务组合 List 的加入和裁剪操作,让列表只保留近期 3 条记录,再用 Pipeline 同时读取两个互不相关的键。

// 请在这里编写代码
// 提示:lPush、lTrim、exec、execAsPipeline

🎉 恭喜你已经掌握原子操作、事务与 Pipeline 的使用边界啦!