Express-session无法返回含自定义数据的完整Session对象

1. 优先排查Cookie的secure配置 #

你的session Cookie设置了secure: true，这个选项要求仅在HTTPS连接下浏览器才会发送Cookie。如果是本地HTTP环境开发，浏览器会直接忽略该Cookie，导致后续请求无法携带Session ID，服务器自然加载不到Redis中存储的用户数据。

调整配置，根据环境动态设置secure：

const sessionOptions: SessionOptions = {
  secret: "secret key",
  resave: false, // 建议改为false，减少不必要的存储写入
  saveUninitialized: false, // 未初始化的Session不存储，更符合安全规范
  cookie: { 
    secure: process.env.NODE_ENV === 'production', // 仅生产环境开启secure
    httpOnly: true,
    sameSite: 'lax' // 建议添加，提升Cookie安全性
  },
  store: store,
};

2. 确保TypeScript类型声明全局生效 #

虽然当前TypeScript没有报错，但把扩展声明放在服务器文件顶部可能存在作用域问题。建议将类型声明移到单独的.d.ts文件中（比如src/types/express-session.d.ts）：

declare module "express-session" {
  interface SessionData {
    userId: string;
    role: UserRole;
  }
}

然后在tsconfig.json中确保该文件被包含：

{
  "include": ["src/**/*", "src/types/**/*.d.ts"]
}

3. 验证请求是否携带Session Cookie #

后续接口请求时，必须确保请求头包含Cookie字段，值为登录接口返回的connect.sid（默认Session Cookie名称）。如果Postman没有自动携带，手动添加该请求头再测试。

4. 手动触发Session保存 #

登录时设置完自定义字段后，手动调用save()方法确保数据及时写入存储，避免异步写入延迟：

request.session.userId = user._id.toHexString();
request.session.role = user.role;

request.session.save((err) => {
  if (err) console.error('Session保存失败:', err);
  console.log(request.session);
});

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