Redis 连接管理、安全与性能排查

管理 Node.js Redis 连接,限制访问权限,并使用常用指标排查性能问题。

🎯 引言

学完本文,你能为长期运行的服务配置连接重试和受限账号,并按连接、命令、内存三个方向排查 Redis 延迟。

本篇使用 Node.js 22.9.0、redis 5.9.0、Redis 7.4.2。入门篇已说明如何建立连接,本篇只补充长期运行时需要的重连、认证与诊断配置。


🧱 Node.js 客户端连接复用与断线重连

连接复用是让多次操作使用同一个已建立的客户端连接,减少反复创建连接的开销。断线重连是在连接中断后,重新尝试建立连接,它恢复的是通信能力,不代表之前失败的操作已重新执行。

应用场景:长期运行的 Node.js 服务应让普通读写复用客户端。订阅、阻塞读取和 WATCH 等有连接状态要求的任务,再使用专门连接。

新建 managed-redis.mjs,先定义有限次数的重连策略:

managed-redis.mjs
import { createClient } from 'redis';

function reconnectStrategy(retries) {
    if (retries >= 5) return false;
    return Math.min(100 * 2 ** retries, 3000) + Math.floor(Math.random() * 100);
}

重试之间逐渐增加等待,并加入少量随机延迟,避免多个实例同时反复连接。5 次用尽后停止;服务需告警并按部署策略重启或恢复,不能假设之后会自动恢复。

再创建可复用客户端:

managed-redis.mjs
export const managedRedis = createClient({
    url: process.env.REDIS_URL ?? 'redis://127.0.0.1:6379',
    username: process.env.REDIS_USERNAME,
    password: process.env.REDIS_PASSWORD,
    disableOfflineQueue: true,
    commandsQueueMaxLength: 1000,
    socket: { connectTimeout: 1000, reconnectStrategy },
});
managedRedis.on('error', error => console.error('Redis 客户端错误:', error.message));

disableOfflineQueue 和 connectTimeout 沿用入门设置;新增的 commandsQueueMaxLength 限制等待中的命令数量,1000 只是示例值。连接尚未被判定断开时,命令仍可能等待,具体处理可复用缓存保护篇的等待期限方案。

用一个独立脚本 managed-check.mjs 检查这份配置能否建立连接:

managed-check.mjs
import { managedRedis } from './managed-redis.mjs';

try {
    await managedRedis.connect();
    console.log('Redis 连接已建立');
} catch (error) {
    console.error('无法连接 Redis:', error.message);
    process.exitCode = 1;
} finally {
    if (managedRedis.isOpen) managedRedis.destroy();
}
node --env-file=.env managed-check.mjs && echo '可以继续后续操作'

连接成功时输出连接提示,终端继续执行后面的命令;重试次数用尽后脚本以非零退出码结束,后面的命令不执行。这个脚本只检查连接配置,不负责持续监控运行中的业务。

服务退出时关闭共用客户端。每次命令调用仍需处理失败,不能只依赖客户端的连接状态。


🔐 Redis 认证与 ACL 权限控制

认证用于验证连接者的身份;ACL 是访问控制列表,用于规定账号可以执行哪些命令、访问哪些 Key。通过权限规则,可以将应用所需的读写能力与管理能力分开。

应用场景:只读程序只授予读取指定前缀的权限,避免错误写入或清理其他模块的数据。应用账号不应继承管理员的全部能力。

下面只在本机练习 Redis 上创建 course_reader,让它读取 course:cache:*。先在本地 .env 配置随机的 COURSE_READER_PASSWORD,再创建 acl-admin.mjs,使用有 ACL 管理权限的连接执行一次:

acl-admin.mjs
import { redis } from './redis.mjs';

const password = process.env.COURSE_READER_PASSWORD;
if (!password || password.length < 32) throw new Error('请配置随机练习账号密码');
await redis.connect();

设置权限:

acl-admin.mjs
console.log(await redis.sendCommand([
    'ACL', 'SETUSER', 'course_reader', 'reset', 'on', `>${password}`,
    '~course:cache:*', '+get', '+ping',
]));
await redis.close();

输出 OK。reset 清除该练习账号旧规则,on 启用账号,> 设置密码,~ 限定键范围,+get 与 +ping 只授予这两条命令。

node --env-file=.env acl-admin.mjs

这是运行时配置。生产环境应通过受控 ACL 文件或服务平台保存规则,避免重启后丢失;不要直接重置正在被业务使用的账号。详见 Redis ACL。


🧰 环境变量与连接配置

验证受限账号时,在 .env 中把 REDIS_USERNAME 设为 course_reader,REDIS_PASSWORD 设为刚创建账号的密码,地址继续使用本机实例。不要将密码写进示例源码或打印完整连接 URL。

创建 acl-check.mjs,复用前面的生产客户端配置:

acl-check.mjs
import { managedRedis } from './managed-redis.mjs';

await managedRedis.connect();
console.log(await managedRedis.get('course:cache:user:v1:1'));

返回缓存文本或 null,说明允许读取这个前缀。尝试写入会被拒绝:

acl-check.mjs
try {
    await managedRedis.set('course:cache:user:v1:1', 'blocked');
} catch (error) {
    console.log(error.message);
} finally {
    await managedRedis.close();
}

运行后应看到包含 NOPERM 的错误:

node --env-file=.env acl-check.mjs

远程连接按服务方要求使用 rediss:// 启用 TLS,即传输加密,并校验证书。密码不能代替网络隔离,实例仍应限制可访问来源。


🛠 INFO、SLOWLOG 与 BigKey 问题

内存管理篇已用 INFO 检查容量,本节补充命中指标和命令排查。SLOWLOG 是慢命令日志,记录执行时间达到配置阈值的命令。BigKey 指内容体积或元素数量过大的键,它可能增加读取、传输和处理成本。

应用场景:查询变慢时,先通过指标判断整体变化,再用慢日志定位命令,检查相关键的大小。它们提供排查线索,不能仅凭其中一项就确定原因。这些观测通常需要单独的运维权限。

使用本机管理连接创建 diagnostics.mjs,先读取缓存命中与未命中次数:

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

await redis.connect();
const stats = await redis.info('stats');
const names = ['keyspace_hits:', 'keyspace_misses:'];
console.log(stats.split('\r\n').filter(line => names.some(name => line.startsWith(name))).join('\n'));

keyspace_hits 是查到键的次数,keyspace_misses 是没有查到键的次数。比较同一时间段的增量,可观察键查询的命中比例;这些指标并不区分具体业务。

查看近期 5 条慢日志:

diagnostics.mjs
console.log(await redis.sendCommand(['SLOWLOG', 'GET', '5']));

没有达到慢日志阈值的命令时,结果为空。记录中的执行时长单位为微秒,不包括所有网络传输和客户端等待时间;接口慢但慢日志为空时,还要检查网络、连接队列和应用处理。

最后查看一个已知缓存键的内存占用:

diagnostics.mjs
console.log(await redis.memoryUsage('course:cache:user:v1:1'));
await redis.close();

返回估算字节数,键不存在时为 null。集合还应结合 LLEN、HLEN、SCARD 等检查元素数量;不要为了排查一次性读取整个大集合。

node diagnostics.mjs

本机无认证实验可直接运行;其他环境使用管理员提供的诊断连接。慢日志中可能出现业务参数,不要将整份输出暴露给普通用户。执行时间字段见 SLOWLOG GET 文档。


💡 常见性能问题与排查

现象先查什么常见处理方向
命中下降、数据库读取增加TTL、Key 格式、淘汰增量检查写入和失效规则,评估容量
部分命令耗时明显SLOWLOG、集合规模、脚本长度限制扫描和返回数量,拆分大值
服务端命令快,接口仍慢网络往返、连接数量、应用排队复用连接,适量批量发送,限制并发
写入报内存不足内存限制与淘汰候选清理无用数据,调整容量和策略
出现大量重连网络、账号、服务重启、资源限制先定位原因,再调整重试策略

处理后用同样的请求条件复测。不要只提高连接数、超时或重试次数,这些设置可能把短暂问题变成更多排队。


❓ 知识问答

Q1:每个请求开一个客户端会更安全吗?

普通读写通常不需要。频繁握手增加连接和资源开销,特殊任务才单独使用连接。

Q2:ACL 允许 GET,就能读取所有键吗?

还要看键范围规则。本文账号只能读取 course:cache:*,其他前缀仍会被拒绝。

Q3:SLOWLOG 为空能证明 Redis 链路正常吗?

不能。慢日志只覆盖满足阈值的服务端命令执行,网络、连接等待和应用处理仍可能很慢。


🧪 小练习

用只读账号读取允许前缀和其他前缀,比较结果;在练习环境使用不可达的 Redis 地址运行连接验证脚本,观察重连次数用尽后如何报告失败。

// 请在这里编写代码

🎉 恭喜你已经掌握连接复用、权限验证与 Redis 排查的基本方法啦!