Express.session内存泄漏警告：NestJS生产环境解决最佳实践咨询

生产环境下必须替换默认的MemoryStore，以下是几种成熟的替代方案及配置步骤：

方案一：Redis（推荐，性能最优） #

Redis是内存型存储，适合高并发场景，是session存储的首选。

1. 安装依赖

npm install connect-redis redis @nestjs/express-session

2. 在NestJS模块中配置

import { Module } from '@nestjs/common';
import { SessionModule } from '@nestjs/express-session';
import { createClient } from 'redis';
import { RedisStore } from 'connect-redis';

@Module({
  imports: [
    SessionModule.forRootAsync({
      useFactory: async () => {
        const redisClient = createClient({
          url: process.env.REDIS_URL || 'redis://localhost:6379',
        });
        await redisClient.connect().catch(console.error);

        return {
          store: new RedisStore({ client: redisClient }),
          secret: process.env.SESSION_SECRET || 'your-strong-secret-key',
          resave: false,
          saveUninitialized: false,
          cookie: {
            secure: process.env.NODE_ENV === 'production',
            httpOnly: true,
            maxAge: 24 * 60 * 60 * 1000, // 1天有效期
          },
        };
      },
    }),
  ],
})
export class AppModule {}

方案二：MongoDB #

如果你的项目已经使用MongoDB，可以直接复用现有数据库存储session。

1. 安装依赖

npm install connect-mongo mongoose @nestjs/express-session

2. 在NestJS模块中配置

import { Module } from '@nestjs/common';
import { SessionModule } from '@nestjs/express-session';
import * as MongoStore from 'connect-mongo';
import { MongooseModule } from '@nestjs/mongoose';

@Module({
  imports: [
    MongooseModule.forRoot(process.env.MONGODB_URI || 'mongodb://localhost:27017/nest-sessions'),
    SessionModule.forRoot({
      store: MongoStore.create({
        mongoUrl: process.env.MONGODB_URI || 'mongodb://localhost:27017/nest-sessions',
        collectionName: 'sessions',
      }),
      secret: process.env.SESSION_SECRET || 'your-strong-secret-key',
      resave: false,
      saveUninitialized: false,
      cookie: {
        secure: process.env.NODE_ENV === 'production',
        httpOnly: true,
        maxAge: 24 * 60 * 60 * 1000,
      },
    }),
  ],
})
export class AppModule {}

方案三：PostgreSQL #

适合使用PostgreSQL的项目，需先创建session存储表。

1. 安装依赖

npm install connect-pg-simple pg @nestjs/express-session

2. 创建PostgreSQL session表
   执行以下SQL语句初始化存储表：

CREATE TABLE "session" (
  "sid" varchar NOT NULL COLLATE "default",
	"sess" json NOT NULL,
	"expire" timestamp(6) NOT NULL
)
WITH (OIDS=FALSE);
ALTER TABLE "session" ADD CONSTRAINT "session_pkey" PRIMARY KEY ("sid") NOT DEFERRABLE INITIALLY IMMEDIATE;
CREATE INDEX "IDX_session_expire" ON "session" ("expire");

3. 在NestJS模块中配置

import { Module } from '@nestjs/common';
import { SessionModule } from '@nestjs/express-session';
import * as pgSession from 'connect-pg-simple';
import { Pool } from 'pg';

const PgStore = pgSession(require('express-session'));

@Module({
  imports: [
    SessionModule.forRoot({
      store: new PgStore({
        pool: new Pool({
          connectionString: process.env.DATABASE_URL || 'postgresql://user:password@localhost:5432/nest-db',
        }),
        tableName: 'session',
      }),
      secret: process.env.SESSION_SECRET || 'your-strong-secret-key',
      resave: false,
      saveUninitialized: false,
      cookie: {
        secure: process.env.NODE_ENV === 'production',
        httpOnly: true,
        maxAge: 24 * 60 * 60 * 1000,
      },
    }),
  ],
})
export class AppModule {}

通用注意事项 #

• 所有敏感配置（密钥、数据库连接串）必须通过环境变量注入，禁止硬编码
• 生产环境务必开启cookie.secure=true，确保session cookie仅通过HTTPS传输
• 根据业务需求调整cookie.maxAge，设置合理的session过期时间
• 若使用Docker部署，需在docker-compose-prod.yaml中配置对应的存储服务（Redis/MongoDB/PostgreSQL），并确保应用容器能访问到这些服务

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