Express中跨路由req.session自定义字段丢失问题求助

嘿，我之前也踩过类似的坑！咱们一步步来排查可能的原因，大概率能找到问题所在：

1. 最常见的问题：Session中间件挂载顺序不对 #

Express是严格按照中间件的挂载顺序执行的，如果你的/approve路由定义在session中间件之前，那这个路由根本就访问不到已设置的session自定义字段——因为session中间件还没给req挂载session对象呢！

举个典型的错误写法：

// 先定义了路由，再挂session中间件，这会导致/approve拿不到session字段
app.get("/approve", async (req, res) => {
  var sess = req.session;
  console.log(sess);
});

// 后挂载session中间件
app.use(session({
  secret: 'your-own-secret-key',
  resave: false,
  saveUninitialized: true
}));

正确的姿势是先挂载session中间件，再定义所有需要用到session的路由：

// 先把session中间件挂上，让所有后续路由都能访问session
app.use(session({
  secret: 'your-own-secret-key',
  resave: false,
  saveUninitialized: true
}));

// 再定义你的两个路由
app.get("/mod", async (req, res) => {
  var sess = req.session;
  console.log(sess);
});

app.get("/approve", async (req, res) => {
  var sess = req.session;
  console.log(sess);
});

2. Session保存时机是否有问题 #

你在/mod路由里设置uid、utag这些字段后，有没有确保session被正确持久化？默认情况下，Express Session会在响应结束时自动保存修改过的session，但如果你的/mod路由里有异步操作没处理好（比如没await异步任务），可能导致session还没写完就结束了响应？不过看你的/mod已经能打印出字段，这个可能性相对小，但可以排查下：如果是在异步逻辑里设置的session，记得await异步任务，或者手动调用sess.save()强制保存：

app.get("/mod", async (req, res) => {
  var sess = req.session;
  sess.uid = '1234123123';
  sess.utag = 'Tag_etc';
  sess.uav = 'other stuff';
  
  // 手动触发保存（如果异步逻辑需要的话）
  await new Promise((resolve) => sess.save(resolve));
  
  res.send('Session updated');
});

3. 子路由/路由分组的中间件覆盖问题 #

如果你的/approve路由是挂载在某个单独的Router实例里（比如/api/approve），那要确保这个Router是在session中间件之后被挂载的。比如错误写法：

// 先挂载子路由，再挂session中间件，子路由里拿不到session
const apiRouter = express.Router();
apiRouter.get("/approve", async (req, res) => { ... });
app.use('/api', apiRouter);

app.use(session(...));

正确的做法是先挂session中间件，再挂载子路由：

app.use(session(...));

const apiRouter = express.Router();
apiRouter.get("/approve", async (req, res) => { ... });
app.use('/api', apiRouter);

4. Cookie路径/域名的配置问题 #

看你打印的cookie信息，path: '/'是全局路径，理论上所有根路径下的路由都能拿到，但如果你的/approve路由在不同子域名下，或者你在session配置里不小心修改了cookie.path，也可能导致拿不到。不过从你的情况看，两个路由都是根路径下的，这个可能性不大，但可以检查下session配置里的cookie参数有没有异常。

5. 第三方Session存储的问题 #

如果你用了Redis、MongoDB这类外部session存储（不是默认的内存存储），可能存在存储读写延迟或者服务异常？比如/mod设置完session后，存储还没同步，/approve就去读了。如果是内存存储的话，这个问题不存在；如果用了外部存储，可以检查下存储服务是否正常，有没有报错日志。

优先排查中间件顺序的问题，这是最容易踩的坑！

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