Redis 连接管理、安全与性能排查
🎯 引言
学完本文,你能为长期运行的服务配置连接重试和受限账号,并按连接、命令、内存三个方向排查 Redis 延迟。
本篇使用 Node.js 22.9.0、redis 5.9.0、Redis 7.4.2。入门篇已说明如何建立连接,本篇只补充长期运行时需要的重连、认证与诊断配置。
🧱 Node.js 客户端连接复用与断线重连
连接复用是让多次操作使用同一个已建立的客户端连接,减少反复创建连接的开销。断线重连是在连接中断后,重新尝试建立连接,它恢复的是通信能力,不代表之前失败的操作已重新执行。
应用场景:长期运行的 Node.js 服务应让普通读写复用客户端。订阅、阻塞读取和 WATCH 等有连接状态要求的任务,再使用专门连接。
新建 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 次用尽后停止;服务需告警并按部署策略重启或恢复,不能假设之后会自动恢复。
再创建可复用客户端:
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 检查这份配置能否建立连接:
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 管理权限的连接执行一次:
import { redis } from './redis.mjs';
const password = process.env.COURSE_READER_PASSWORD;
if (!password || password.length < 32) throw new Error('请配置随机练习账号密码');
await redis.connect();
设置权限:
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,复用前面的生产客户端配置:
import { managedRedis } from './managed-redis.mjs';
await managedRedis.connect();
console.log(await managedRedis.get('course:cache:user:v1:1'));
返回缓存文本或 null,说明允许读取这个前缀。尝试写入会被拒绝:
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,先读取缓存命中与未命中次数:
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 条慢日志:
console.log(await redis.sendCommand(['SLOWLOG', 'GET', '5']));
没有达到慢日志阈值的命令时,结果为空。记录中的执行时长单位为微秒,不包括所有网络传输和客户端等待时间;接口慢但慢日志为空时,还要检查网络、连接队列和应用处理。
最后查看一个已知缓存键的内存占用:
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 排查的基本方法啦!
