Express-session无法保存求助：req.session.user始终为undefined

核心问题定位 #

全局路由（app.get/post）中 Session 正常，但用 express.Router() 定义的路由里 Session 无法持久化，设置后退出函数就变回 undefined，大概率是中间件加载顺序错误或路由挂载配置问题。

常见原因及解决方案 #

1. 必须先加载 Session 中间件，再挂载 Router #

Express 中间件按执行顺序生效，如果 app.use(session(...)) 写在路由挂载之后，Router 中的请求不会经过 Session 中间件，自然无法读写 Session。

正确示例（server.js）：

const express = require('express');
const session = require('express-session');
const userRouter = require('./user-route');

const app = express();

// 第一步：加载 Session 中间件
app.use(session({
  secret: 'your-custom-secret-key', // 必填，用于签名 Session ID
  resave: false, // 避免无变动时重复保存 Session
  saveUninitialized: false, // 仅当 Session 有修改时才保存
  cookie: {
    secure: false, // 开发环境设为 false，生产环境 HTTPS 下改为 true
    maxAge: 24 * 60 * 60 * 1000 // Session 有效期1天
  }
}));

// 第二步：挂载 Router
app.use('/user', userRouter);

2. 异步操作中需手动调用 req.session.save() #

如果在异步逻辑（比如数据库查询）中设置 Session，必须在异步操作完成后手动调用保存方法，不能设置后直接返回响应：

正确示例（user-route.js）：

const router = require('express').Router();

router.post('/login', async (req, res) => {
  // 模拟异步查询用户
  const user = await User.findOne({ email: req.body.email });
  
  if (user) {
    req.session.user = { id: user._id, name: user.name };
    // 异步操作完成后手动保存 Session
    req.session.save((err) => {
      if (err) return res.status(500).send('Session 保存失败');
      res.send('登录成功');
    });
  } else {
    res.status(401).send('用户不存在');
  }
});

3. 检查 Cookie 配置是否合理 #

• 开发环境下 cookie.secure 必须设为 false（HTTP 协议无法承载 secure Cookie），生产环境 HTTPS 下改为 true；
• 若前后端域名不一致，需配置 cookie.domain 或设置 sameSite: 'lax'（跨域场景可配合 secure: true 设为 'none'）。

4. 禁止在 Router 中重复初始化 Session #

不要在 Router 的中间件里再次调用 session() 函数，这会覆盖全局 Session 配置，导致原有 Session 失效。

快速测试方法 #

在 Router 的路由处理函数中打印 req.session，判断 Session 中间件是否生效：

router.get('/profile', (req, res) => {
  console.log(req.session); // 若输出 undefined，说明中间件顺序错误
  res.send(req.session.user || '未登录');
});

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