NodeJS Express会话超时本地正常Linux服务器异常问题排查

代码配置核对 #

检查app.js的会话核心配置 #

先确认app.js中express-session的配置是否明确设置了2小时超时，正确配置示例：

app.use(session({
  secret: 'your-secret-key',
  resave: false,
  saveUninitialized: false,
  cookie: {
    maxAge: 2 * 60 * 60 * 1000, // 2小时（7200000毫秒）
    secure: process.env.NODE_ENV === 'production', // 生产环境必须开启secure
    httpOnly: true
  }
}));

• 重点确认maxAge数值是否正确，有没有被生产环境的环境变量意外覆盖
• 排查代码中是否存在多次注册session中间件的情况，后续的配置会覆盖之前的设置

检查login.js的登录逻辑 #

确认登录时有没有手动修改会话过期时间，比如：

req.session.cookie.maxAge = 2 * 60 * 60 * 1000;

如果有这段代码，检查数值是否写错（比如误写为10分钟的600000毫秒）

服务器环境排查 #

依赖版本一致性 #

对比本地与服务器的express-session版本：

• 本地执行npm list express-session，服务器执行同样命令
• 若版本不一致，服务器旧版本可能存在配置兼容问题，执行npm install express-session@本地对应版本同步版本

Forever进程管理验证 #

• 执行forever list，确认进程对应的文件路径是/home/centos/myProject/app.js，避免启动了旧备份文件
• 修改配置后必须重启进程：执行forever restart app.js，或者先停再启forever stop app.js && forever start app.js

反向代理配置检查（若有） #

如果项目前端有Nginx等反向代理，需排查：

• 确认proxy_set_header已正确传递Cookie和Host请求头，否则会话无法正常维持
• 检查Nginx的proxy_connect_timeout、proxy_read_timeout设置，若值为10分钟，会提前断开连接导致会话失效

会话存储优化（生产环境必做） #

默认的内存存储会话在Linux内存不足时会被系统回收，导致会话提前失效。建议换成持久化存储，比如connect-redis：

npm install connect-redis redis

修改session配置：

const RedisStore = require('connect-redis').default;
const redis = require('redis');

const client = redis.createClient({
  // 填写你的Redis连接参数
});

app.use(session({
  store: new RedisStore({ client: client }),
  secret: 'your-secret-key',
  resave: false,
  saveUninitialized: false,
  cookie: {
    maxAge: 2 * 60 * 60 * 1000,
    secure: true,
    httpOnly: true
  }
}));

验证步骤 #

1. 登录服务器上的项目，查看浏览器会话Cookie的过期时间，确认是否为2小时后
2. 等待10分钟后访问需登录页面，验证是否仍能正常访问；等待2小时后，确认是否自动重定向到登录页

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