Redis 简介与 Node.js 集成

认识 Redis 的用途与特点,使用 Docker 启动服务并通过 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 的区别

比较项RedisMySQL
数据组织通过 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,后续文章直接复用这个文件:

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,导入客户端并连接:

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

await redis.connect();

导入模块只创建客户端对象,connect() 完成后才能执行命令。error 监听器记录连接异常;具体命令仍可能失败,不能用这个监听器代替调用处的错误处理。


💡 使用 set()、get() 完成第一次读写

把下面各组代码依次追加到 hello.mjs。先写入一段文本:

hello.mjs
const result = await redis.set('course:hello', 'Hello Redis');
console.log(result);

输出 OK,表示写入成功。第一个参数是 Key,第二个是文本值。

再按相同的 Key 读取:

hello.mjs
console.log(await redis.get('course:hello'));

输出 Hello Redis。读取不存在的 Key 时返回 null。

这个脚本只运行一次,结束前关闭连接:

hello.mjs
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 的首次连接和读写啦!