NestJS中@Session()装饰器返回undefined问题求助

嘿，我之前也踩过这个一模一样的坑！虽然NestJS是基于Express构建的，但它不会自动帮你启用Session支持——你得手动把Express的Session中间件集成到NestJS的请求流程里，这就是为什么原生Express里req.session正常，但NestJS的@Session()却返回undefined的核心原因。

下面是一步步的解决方法：

1. 安装必要依赖 #

首先确保你安装了Express生态中处理Session的核心包express-session：

npm install express-session
# 或者用yarn
yarn add express-session

2. 在NestJS中配置Session中间件 #

打开项目根目录的main.ts，在创建应用实例后、监听端口前，添加Session中间件的配置（这一步是关键！）：

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import * as session from 'express-session';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  
  // 配置Session中间件
  app.use(
    session({
      secret: 'your-strong-secret-key', // 替换成你的专属密钥，生产环境务必存在环境变量中
      resave: false, // 禁止强制保存未修改的Session
      saveUninitialized: false, // 禁止保存未初始化的Session（比如用户未登录时的空Session）
      cookie: {
        secure: false, // 生产环境使用HTTPS时，请将此值设为true
        maxAge: 3600000, // Session过期时间，示例为1小时
      },
    }),
  );
  
  await app.listen(3000);
}
bootstrap();

3. 确认控制器的模块注册 #

你已经确认从@nestjs/common正确导入了@Session()，这步没问题，但要确保你的控制器已经被正确注册到对应模块中。比如在AppModule的controllers数组里包含你的控制器类：

import { Module } from '@nestjs/common';
import { YourController } from './your.controller';

@Module({
  controllers: [YourController],
})
export class AppModule {}

关键注意事项 #

• 中间件顺序不能错：session中间件必须在所有路由/控制器挂载之前配置，否则请求到达控制器时还没经过Session处理，@Session()自然拿不到值。
• 生产环境存储优化：不要使用express-session默认的内存存储（MemoryStore），生产环境建议换成持久化存储（比如connect-redis或connect-mongo），避免服务器重启后Session全部丢失。

现在再调用你的/foo接口，sess应该就不会是undefined了——第一次访问可能是空对象，但你可以给它赋值（比如sess.user = { id: 123 }），后续请求就能正常读取到这个值啦！

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