Node.js + Redis 实现分布式 Session 共享：通过 express-session 配合 connect-redis，将 Session 统一存储于 Redis，使多实例共享会话数据，解决负载均衡下登录状态不一致问题。
JavaScript 本身（前端）不直接操作 Redis 或管理 Session，真正实现分布式会话共享的是后端 Node.js 应用。核心思路是：用 Redis 作为统一的 Session 存储后端，替代默认的内存存储，让多个服务实例共享同一份会话数据。
为什么需要 Redis 实现 Session 共享
在集群或负载均衡环境下，用户请求可能被分发到不同服务器。如果 Session 存在各自进程内存中，就会出现“登录了 A 服务器，访问 B 服务器却提示未登录”的问题。Redis 作为中心化、高可用、支持过期的键值存储，天然适合作为跨进程/跨机器的 Session 数据库。
Node.js 中使用 express-session + connect-redis
这是最主流的组合。以 Express 框架为例：
- 安装依赖：npm install express express-session connect-redis redis
- 创建 Redis 客户端（推荐 v4+ 的
redis包，支持 Promise 和连接池） - 初始化
RedisStore并传入 session 中间件
示例代码片段：
Ai Coach Batch Session Summary
下载
批量分析录音转写，输出多维度拓客报告。触发词：录音分析、总结、音频总结、拜访记录总结。当用户提及「分析录音」「看看录音数据」「最近的录音」「通话记录」且意图为批量统计/分析时触发。仅出现「录音」或「拜访」时需结合上下文，若仅查看单条详情则不触发。
立即学习“Java免费学习笔记（深入）”；
const express = require('express');
const session = require('express-session');
const { createClient } = require('redis');
const RedisStore = require('connect-redis').default;
<p>const redisClient = createClient({ url: 'redis://localhost:6379' });
redisClient.connect().catch(console.error);</p><p>const app = express();</p><p>app.use(session({
store: new RedisStore({ client: redisClient }),
secret: 'your-secret-key',
resave: false,
saveUninitialized: false,
cookie: {
secure: false, // 生产环境建议 true（配合 HTTPS）
httpOnly: true,
maxAge: 30 <em> 60 </em> 1000 // 30 分钟
}
}));</p><p>app.get('/login', (req, res) => {
req.session.userId = 123;
res.send('Logged in');
});</p><p>app.get('/profile', (req, res) => {
res.json({ userId: req.session.userId }); // 多实例下也能读到
});
关键配置与注意事项
- 连接复用：确保所有服务实例共用同一个 Redis 实例（或集群），且连接客户端是单例，避免频繁重连
-
Session ID 传递：依赖 Cookie（默认字段
connect.sid）。确保反向代理（如 Nginx）未过滤或修改 Cookie -
序列化安全：不要在
req.session中存函数、Promise、Buffer 等非 JSON 可序列化对象；Redis 存的是字符串，会自动 JSON.stringify -
过期一致性：Redis 的 key 过期时间由
cookie.maxAge决定，express-session会在每次请求时刷新 TTL，无需额外维护 - 生产加固：启用 Redis 密码认证、设置连接超时、使用 TLS 加密通信、监控 Redis 内存与命中率
可选增强：支持多实例失效与广播
默认情况下，Session 过期由 Redis 自动清理，但有时需要主动销毁（如用户登出、密码修改）。此时调用 req.session.destroy() 即可删除对应 key。若需通知其他服务实例（例如清除本地缓存），可结合 Redis Pub/Sub 或外部事件总线，但这已超出 Session 共享基本需求，属于进阶场景。
