当前位置：首页 > news >正文

Nodejs操作缓存数据库-Redis

news 2025/7/28 7:36:56

Hi I’m Shendi

Nodejs专栏
Nodejs操作缓存数据库-Redis

在服务端开发中，缓存数据库也是不可或缺的，可以提高程序并发以及方便后续扩展，而目前最常用的莫过于Redis了

安装依赖

和之前的mysql一样，redis的依赖最常用的就是redis

npm install redis

依赖对应的github地址：https://github.com/redis/node-redis

这是Redis官方给的NodeJS连接指南 https://redis.io/docs/clients/nodejs/

关于 Redis 的安装使用等操作可以看这篇文章：https://sdpro.top/blog/html/article/1023.html

连接示例

下面是官方的示例代码

import { createClient } from 'redis';const client = createClient();client.on('error', err => console.log('Redis Client Error', err));await client.connect();await client.set('key', 'value');
const value = await client.get('key');
await client.disconnect();

上面的代码连接到 localhost:6379，要连接到其他地址，使用以下格式

redis[s]://[[username][:password]@][host][:port][/db-number]

例如

createClient({url: 'redis://alice:foobared@awesome.redis.server:6380/0'
});

其中 username 账号，password 密码，host主机地址，port端口，db-number使用的数据库下标，默认0

有关更多信息参考文档： client configuration guide

要检查客户端是否已连接并准备好发送命令，请使用client. isReady，它返回一个布尔值。client. isOpen也可用。当客户端的底层套接字打开时，此函数返回true，当它不打开时（例如，当客户端在网络错误后仍在连接或重新连接时），此函数返回false。

库的操作基本上都是异步的，上面使用到 await，那么就需要将当前函数设置为 async 异步，例如

async function test() {await client.connect();
}

因为是异步，就需要我们自行控制错误的处理

这里提一嘴，这里的异步全是返回的Promise，所以可以使用Promise的方式

比起解构赋值，我更喜欢以下方式

var redis = require("redis");
const client = redis.createClient();client.on('error', err => console.log('Redis Client Error', err));await client.connect();await client.set('key', 'value');
const value = await client.get('key');
await client.disconnect();

无需关心连接及连接池

Node_redis自动管理连接，因此无需等待连接或回调。由于Node.js和Redis实际上都是单线程的，除了少数例外，不需要使用多个客户端实例或任何池机制；最常见的例外是，如果您使用Pub/Sub订阅，或者使用流或列表进行阻塞，那么您需要有专门的客户端来接收这些长时间运行的命令。

例如连接一个错误的Redis地址，将会一直进行重连

在这里插入图片描述

使用

该库对所有开箱即用的Redis命令都提供了内置支持。这些命令使用原始的Redis命令名（HSET、HGETALL等）和一个更友好的驼峰式版本（hSet、hGetAll等）进行暴露：

// 原始redis命令
await client.HSET('key', 'field', 'value');
await client.HGETALL('key');// 友好的js命令
await client.hSet('key', 'field', 'value');
await client.hGetAll('key');

要指定命令的修饰符，可以使用一个JavaScript对象：

await client.set('key', 'value', {EX: 10,NX: true
});

上面的EX是过期时间，单位秒，NX为true时，当键不存在才会进行设置，更多的参数查阅Redis的使用，可以参考https://sdpro.top/blog/html/article/1023.html

获取的内容将被转换为有用的结构

await client.hGetAll('key'); // { field1: 'value1', field2: 'value2' }
await client.hVals('key'); // ['value1', 'value2']

该库也支持 Buffer：

await client.hSet('key', 'field', Buffer.from('value')); // 'OK'
await client.hGetAll(commandOptions({ returnBuffers: true }),'key'
); // { field: <Buffer 76 61 6c 75 65> }

如果您想运行Node Redis还不支持的命令（还！），请使用.sendCommand()：

await client.sendCommand(['SET', 'key', 'value', 'NX']); // 'OK'
await client.sendCommand(['HGETALL', 'key']); // ['key1', 'field1', 'key2', 'field2']

事务（Multi/Exec）

通过调用.multi()开始一个事务，然后将您的命令串联起来。完成后，调用.exec()，您将获得一个包含您的结果的数组：

await client.set('another-key', 'another-value');const [setKeyReply, otherKeyValue] = await client.multi().set('key', 'value').get('another-key').exec(); // ['OK', 'another-value']

您也可以通过调用.watch()来监视键。如果任何监视的键发生更改，事务将中止。
要深入了解事务，请查看Isolated Execution Guide.

事件

Node Redis客户端类是一个Nodejs EventEmitter，每次网络状态发生变化时，它都会发出一个事件：

名称	何时发生	监听参数
`connect`	启动与服务器的连接	No arguments
`ready`	客户端已准备好使用	No arguments
`end`	连接已关闭（通过`.quit（）`或`.disconnect（）`）	No arguments
`error`	出现错误——通常是网络问题，如 “Socket closed unexpectedly”	`(error: Error)`
`reconnecting`	客户端正在尝试重新连接到服务器	No arguments
`sharded-channel-moved`	See here	See here