解决connect-redis在NestJS中的类型冲突问题

问题背景

在使用connect-redis库为NestJS应用配置Redis会话存储时，开发者可能会遇到两个常见错误：

1. "Only a void function can be called with the 'new' keyword"错误
2. "TypeError: (0 , connect_redis_1.default) is not a function"错误

这些错误通常与类型定义和模块导入方式有关。

错误原因分析

类型定义冲突

主要问题源于同时安装了@types/connect-redis类型定义包和connect-redis自带的类型定义。connect-redis从某个版本开始已经内置了TypeScript类型定义，再额外安装@types/connect-redis会导致：

1. 类型定义重复
2. 类型定义可能不一致
3. 类型推断混乱

错误的导入方式

另一个常见错误是使用了不正确的导入语法，如尝试使用new RedisStore(session)({...})这种链式调用方式，这是不正确的用法。

正确配置方式

1. 移除冲突的类型定义

首先需要移除可能导致冲突的@types/connect-redis包：

yarn remove @types/connect-redis
# 或
npm uninstall @types/connect-redis

2. 正确的导入和初始化方式

在NestJS中正确配置connect-redis的示例：

import { RedisStore } from "connect-redis";
import session from "express-session";
import { createClient } from "redis";

// 初始化Redis客户端
const redisClient = createClient();
redisClient.connect().catch(console.error);

// 初始化Redis存储
const redisStore = new RedisStore({
  client: redisClient,
  prefix: "myapp:",
});

// 在NestJS中配置会话中间件
app.use(
  session({
    store: redisStore,
    resave: false, // 推荐设置为false
    saveUninitialized: false, // 推荐设置为false
    secret: "your-secret-key",
  })
);

技术要点

1. 类型定义来源：现代Node.js库越来越多地采用内置类型定义的方式，而不是依赖DefinitelyTyped的@types包。在遇到类型问题时，首先检查库本身是否已经提供了类型定义。

2. Redis连接：使用createClient从redis包创建客户端后，需要显式调用connect()方法建立连接，并妥善处理连接错误。

3. 会话配置：resave和saveUninitialized选项的合理设置对性能有重要影响，生产环境中通常建议都设为false。

最佳实践建议

1. 在使用任何库前，先查阅其官方文档了解正确的TypeScript支持方式
2. 避免同时使用库内置类型和@types下的类型定义
3. 对于会话存储，考虑添加适当的错误处理和重连逻辑
4. 在生产环境中使用更强的密钥和更严格的会话配置

通过遵循这些指导原则，可以避免类型冲突问题，并建立可靠的Redis会话存储解决方案。