Redis 简介与 Node.js 集成
🎯 引言
学完本文,你能说明 Redis 是什么、适合用在哪里,并在 Node.js 中完成基本的数据写入和读取。
🧱 Redis 是什么
Redis 是一种主要在内存中读写数据的键值数据库。它负责保存数据,并提供读取、修改和删除数据的命令。内存访问速度较快,因此 Redis 常用于需要频繁读写数据的场合。
键值存储是指通过一个键(Key)找到对应的值(Value)。Key 是数据的标识;Value 是保存的内容。Redis 通常从一个已知的 Key 出发操作数据。
Redis 的值不只有文本,还支持字段集合、列表、集合等数据结构。不同结构提供不同操作,例如修改一个字段、追加一个元素或按分数排序,应用不必每次都取出整份数据后自行处理。
Redis 作为独立服务运行,Node.js 通过客户端连接它、发送命令并接收结果。多个应用进程可以访问同一份 Redis 数据。Redis 还支持设置数据过期时间,以及将数据保存到磁盘以便重启后恢复;具体恢复范围取决于保存配置。
💡 Redis 常用在哪些地方
理解了 Redis 的存储方式,再看几类常见用途:
| 场景 | Redis 在其中的作用 |
|---|---|
| 数据缓存 | 暂存经常查询的结果,减少重复查询数据库 |
| 登录会话 | 保存服务端会话记录,让多个应用实例共享登录状态 |
| 访问计数与限流 | 累计访问次数,为限制一段时间内的请求数量提供依据 |
| 排行榜 | 保存成员及分数,按分数读取排名 |
| 消息通知 | 在不同程序之间发布和接收消息 |
缓存是为了重复使用而临时保存的数据副本。副本不存在时,可以重新从原始数据源取得。缓存是 Redis 的常见用途之一,Redis 本身还提供上述其他能力。
⚖️ Redis 与 MySQL 的区别
| 比较项 | Redis | MySQL |
|---|---|---|
| 数据组织 | 通过 Key 访问字符串、集合等结构 | 使用表、行和列组织数据 |
| 常用查询 | 按键或结构提供的命令操作 | 使用 SQL 筛选、关联、聚合 |
| 存储方式 | 主要在内存中操作,可配置持久化 | 主要面向磁盘持久存储,也使用内存缓存 |
选择依据是数据访问方式和可靠性要求。涉及多表关联等查询时,仍需要使用 MySQL 等关系型数据库。
浏览器调用 Node.js 接口,由后端访问 Redis。不要把 Redis 连接地址和密码交给前端。
🛠 使用 Docker 安装 Redis
先完成 Docker 安装准备,并启动 Docker 服务。本课程固定使用 Redis 7.4.2、Node.js 22.9.0、redis npm 包 5.9.0,用于复现实验,不表示最新版本。
在终端启动练习实例:
docker run -d --name redis-course \
-p 127.0.0.1:6379:6379 \
redis:7.4.2 redis-server --save "" --appendonly no
6379 是 Redis 服务端口;127.0.0.1 让它只接受本机访问。--save "" 和 --appendonly no 关闭这次练习的持久化,停止后数据允许丢失,后面的持久化篇会使用独立实例。
🧰 安装 Node.js redis 客户端并建立连接
客户端负责把 JavaScript 调用发送给 Redis。使用 Node.js 22.9.0,在练习目录安装 redis 5.9.0:
mkdir redis-course
cd redis-course
npm install --save-exact redis@5.9.0
创建 redis.mjs,后续文章直接复用这个文件:
import { createClient } from 'redis';
export const redis = createClient({
url: process.env.REDIS_URL ?? 'redis://127.0.0.1:6379',
disableOfflineQueue: true,
socket: { connectTimeout: 1000, reconnectStrategy: false },
});
redis.on('error', error => console.error('Redis 连接错误:', error.message));
url 是连接地址,可由环境变量 REDIS_URL 覆盖;connectTimeout 将连接等待限制为 1000 毫秒。练习先关闭自动重连,并让断线期间的新命令直接失败,避免脚本一直等待。生产重连策略放在连接管理篇讲解。
再创建 hello.mjs,导入客户端并连接:
import { redis } from './redis.mjs';
await redis.connect();
导入模块只创建客户端对象,connect() 完成后才能执行命令。error 监听器记录连接异常;具体命令仍可能失败,不能用这个监听器代替调用处的错误处理。
💡 使用 set()、get() 完成第一次读写
把下面各组代码依次追加到 hello.mjs。先写入一段文本:
const result = await redis.set('course:hello', 'Hello Redis');
console.log(result);
输出 OK,表示写入成功。第一个参数是 Key,第二个是文本值。
再按相同的 Key 读取:
console.log(await redis.get('course:hello'));
输出 Hello Redis。读取不存在的 Key 时返回 null。
这个脚本只运行一次,结束前关闭连接:
await redis.close();
保存两个文件后执行:
node hello.mjs
终端依次显示 OK 和 Hello Redis。可在 node-redis 连接文档查阅连接选项。
❓ 知识问答
Q1:安装 redis npm 包后,为什么还要启动 Docker 容器?
npm 包只是客户端,容器中运行的 Redis 服务端才负责保存数据。
Q2:出现 ECONNREFUSED 时先检查什么?
先检查容器是否运行,再检查连接地址和映射端口。容器停止时可启动已有容器:
docker start redis-course
Q3:Redis 数据都在内存中,重启就一定丢失吗?
取决于持久化配置,具体保存与恢复方式见持久化篇。
🧪 小练习
将文本改成自己的问候语,再读取一个没有写入过的 Key,比较两次结果。
// 请在这里编写代码
🎉 恭喜你已经完成 Redis 与 Node.js 的首次连接和读写啦!
