Nodemon重启服务后express-session会话无法持久保存的问题

根本原因 #

• 配置项中给会话Cookie设置动态名称，导致每次服务重启后浏览器无法读取原有会话标识
  • express-session 配置中的name参数，是浏览器端存储会话ID的Cookie键名，必须在服务运行期间保持完全固定，否则浏览器无法正常匹配、读取到之前存储的会话Cookie
  • 原代码中写为name: 'pchef' + uuidv4()，每次服务进程启动（包括Nodemon触发的自动重启）都会重新执行一次随机值生成，导致Cookie键名每次重启都完全不同
  • 浏览器只会按服务端指定的当前Cookie键名传递标识，旧键名存储的会话ID不会被发送到服务端，因此服务端永远无法获取到用户之前的会话ID，只能新生成完全独立的会话ID，表现为旧会话彻底丢失
  • 这也解释了为什么MongoDB中会生成新的会话记录：新会话ID被触发了保存逻辑写入数据库，旧的会话记录因为永远无法被读取，就成了库里的无效历史数据
  • 该问题本质和Nodemon工具无关，哪怕手动重启服务，只要存在动态生成Cookie名的逻辑，就会触发会话丢失；Nodemon只是频繁触发服务重启，让这个问题的表现更明显

其他附带代码疏漏 #

• MongoDBStore的初始化错误回调逻辑错误：原代码无论连接是否正常报错，只要触发回调就会打印连接失败日志，实际无法起到错误提示作用，缺乏排查价值

修正方案 #

• 将会话Cookie的名称改为固定值，去掉动态拼接的随机UUID部分
• 修正MongoDBStore的错误回调逻辑，仅在真实捕获到错误时打印日志

修正后的关键配置代码片段：

// 修正后的会话存储初始化
const store = new MongoDBStore(
    {
        uri: process.env.MONGODB_CONNECT,
        collection: 'sessions'
    },
    function (err) {
        // 仅在真实存在错误时打印日志
        if (err) {
            console.log('MongoDBStore connection error:', err);
        }
    }
);

// 修正后的会话配置
app.use(session({
    genid: function () {
        return uuidv4();
    },
    cookie: {
        maxAge: 60 * 1000 * 60 * 24 * 7, // 会话1周后过期
        secure: process.env.NODE_ENV === 'production' ? true : false,
        httpOnly: true
    },
    // 固定Cookie名称，不要动态拼接随机值
    name: 'pchef.sid',
    secret: process.env.SESSION_SECRET,
    resave: false,
    saveUninitialized: false,
    store: store
}));

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