为Express服务器添加Redis Store导致认证策略无法执行

核心问题定位 #

未配置store: new RedisStore()时登录流程正常，配置后请求无限挂起且认证策略内无日志输出，Redis客户端已确认连接成功，问题大概率出在RedisStore的初始化逻辑或会话中间件的依赖顺序上。

排查与修复步骤 #

1. RedisStore初始化必须传入已连接的客户端实例
   你的代码中创建了redisClient但未传入RedisStore，默认情况下RedisStore会尝试新建客户端连接，若新连接未正确建立会导致会话存储阻塞。修改初始化代码：

   // 初始化RedisStore时传入已连接的redisClient
   const redisStore = new RedisStore({ client: redisClient });
   

   并在session中间件中使用该实例：

   app.use(session({
     store: redisStore,
     secret: process.env.SESSION_SECRET,
     resave: false,
     saveUninitialized: false,
     cookie: { secure: process.env.NODE_ENV === 'production' }
   }));
   

2. 确保Redis连接完成后再启动服务器
   redisClient.connect()是异步操作，若服务器在Redis连接就绪前启动，会话存储初始化会因客户端未就绪引发阻塞。可将服务器启动逻辑放在Redis连接成功回调中：

   redisClient.on('connect', () => {
     console.log('Connected to redis successfully');
     app.listen(process.env.PORT, () => {
       console.log(`Server running on port ${process.env.PORT}`);
     });
   });
   

   或用async/await确保连接完成：

   async function startServer() {
     try {
       await redisClient.connect();
       console.log('Connected to redis successfully');
       app.listen(process.env.PORT, () => {
         console.log(`Server running on port ${process.env.PORT}`);
       });
     } catch (err) {
       console.error('Redis connection failed:', err);
       process.exit(1);
     }
   }
   startServer();
   

3. 检查依赖版本兼容性
   connect-redis与express-session版本不匹配会导致初始化异常。确认依赖版本：

   // package.json 示例配置
   {
     "express-session": "^1.17.3",
     "connect-redis": "^7.1.0",
     "redis": "^4.6.7"
   }
   

   若使用connect-redis v6及以下版本，初始化参数需调整：

   const redisStore = new RedisStore({ client: redisClient, ttl: 86400 });
   

4. 确认中间件加载顺序
   会话中间件必须在认证相关中间件（如passport的initialize/session）之前加载，否则会话存储无法生效：

   // 正确的中间件顺序
   app.use(session({ store: redisStore, ... }));
   app.use(passport.initialize());
   app.use(passport.session());
   

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