使用Connect-redis存储Session时出现TypeError: client.get/set不是函数

核心问题分析 #

这个错误几乎都是Redis客户端与connect-redis版本不兼容，或者Redis客户端实例初始化错误导致的。connect-redis不同版本对Redis客户端的API要求差异很大，新手容易混用版本导致方法不存在。

步骤1：匹配正确的版本组合 #

connect-redis v7+ 必须搭配 Redis 客户端 v4；如果用 connect-redis v6 及以下，需要搭配 Redis 客户端 v3。推荐使用最新稳定版组合：

# 卸载旧包
npm uninstall redis connect-redis

# 安装兼容版本
npm install redis@4 connect-redis@7 express-session

步骤2：正确初始化Redis客户端与Session中间件 #

确保严格按照以下代码配置，重点注意显式调用connect()和传递正确的客户端实例：

const express = require('express');
const session = require('express-session');
const { createClient } = require('redis');
const RedisStore = require('connect-redis').default;

const app = express();

// 1. 初始化Redis客户端
const redisClient = createClient({
  url: 'redis://localhost:6379' // 替换为你的Redis服务地址（如带密码则为 redis://user:password@host:port）
});
// 必须显式调用connect()，v4客户端不再自动连接
redisClient.connect().catch(err => console.error('Redis连接失败:', err));

// 2. 创建RedisStore实例
const redisStore = new RedisStore({
  client: redisClient,
  prefix: 'myapp-session:' // 可选，给session键加前缀，避免和其他Redis数据冲突
});

// 3. 配置Session中间件
app.use(session({
  store: redisStore,
  secret: 'your-strong-secret-key', // 替换为你的加密密钥，生产环境用环境变量
  resave: false,
  saveUninitialized: false,
  cookie: {
    httpOnly: true,
    secure: process.env.NODE_ENV === 'production', // 生产环境开启HTTPS时设为true
    maxAge: 24 * 60 * 60 * 1000 // Session有效期1天
  }
}));

步骤3：正确实现登出逻辑 #

不要手动操作Redis客户端删除session，应该用Express Session提供的req.session.destroy()方法，由connect-redis自动处理Redis数据：

app.post('/api/logout', (req, res, next) => {
  req.session.destroy(err => {
    if (err) return next(err);
    // 清除浏览器端的session cookie（cookie名默认是connect.sid，可在session配置中自定义）
    res.clearCookie('connect.sid');
    res.status(200).json({ message: '登出成功' });
  });
});

关键注意事项 #

• Redis服务必须运行：用redis-cli ping测试，返回PONG说明服务正常。如果本地没装Redis，先安装启动。
• 禁止混用版本：不要同时安装redis@3和redis@4，也不要用connect-redis@6配redis@4，会导致API不兼容。
• 不要跳过connect()：Redis v4客户端需要显式调用connect()建立连接，否则客户端实例未就绪，会出现get/set is not a function错误。

内容的提问来源于stack exchange，提问作者bigbossbhris