Express-Session结合Connect-Mongo循环依赖及弃用警告问题求助

嘿，作为Node.js新手遇到跨环境的问题确实头疼，我来帮你一步步排查解决！

首先，你的问题出在两个点：循环依赖错误和未处理Promise拒绝警告，虽然开发机和服务器Node版本只差0.1，但更可能是依赖兼容、连接时机不对导致的差异。

先处理未处理的Promise拒绝警告 #

这个警告的根源是：你直接用mongoose.createConnection返回的连接对象初始化MongoStore，但createConnection是异步操作——服务器端可能连接还没建立完成，代码就已经走到了session中间件初始化，导致Promise没有被正确处理。

修复方法：等待MongoDB连接成功后再初始化Session #

把session中间件的初始化放在连接成功的回调里，确保连接就绪后再使用：

const express = require('express');
const path = require('path');
const expressSession = require('express-session');
const mongoose = require('mongoose');
const MongoStore = require('connect-mongo')(expressSession);
const settings = require('./config/app-settings');

const app = express();

// 改用mongoose.connect（单连接更适合大多数场景），并等待连接成功
mongoose.connect(settings.settings.databaseUri)
  .then(() => {
    console.log('MongoDB 连接成功！');
    
    // 此时再初始化Session中间件
    app.use(expressSession({
      secret: 'secret', // 建议用环境变量存储密钥，不要硬编码
      // cookie: {maxAge: settings.settings.mongoDBSessionMaxAge * 1000}, // 取消注释，和清理时间对应
      resave: false, // 最佳实践：无修改时不强制保存
      saveUninitialized: false, // 最佳实践：不保存未初始化的session
      store: new MongoStore({
        mongooseConnection: mongoose.connection,
        clear_interval: settings.settings.mongoDBSessionMaxAge
      })
    }));

    // 最后启动服务器
    app.listen(settings.settings.port, () => {
      console.log(`服务器运行在端口 ${settings.settings.port}`);
    });
  })
  .catch(err => {
    console.error('MongoDB 连接失败:', err);
    process.exit(1); // 连接失败时退出进程
  });

如果你坚持用createConnection，可以监听连接事件：

const connection = mongoose.createConnection(settings.settings.databaseUri);

connection.on('connected', () => {
  console.log('MongoDB 连接建立');
  app.use(expressSession({ /* 你的配置 */ }));
  app.listen(3000);
});

connection.on('error', err => {
  console.error('MongoDB 连接错误:', err);
});

解决循环依赖错误 #

循环依赖通常是因为connect-mongo和mongoose的版本不兼容，或者使用mongooseConnection方式传递连接时触发了内部循环引用。

修复方案1：改用URL连接方式替代mongooseConnection #

直接给MongoStore传入数据库URL，跳过mongoose连接对象，避免循环依赖：

store: new MongoStore({
  url: settings.settings.databaseUri,
  clear_interval: settings.settings.mongoDBSessionMaxAge
})

修复方案2：调整依赖版本 #

你的服务器用Node v8.9.3，属于较老的版本，新版本的connect-mongo或mongoose可能对它支持不好。可以尝试：

• 降级mongoose到v4.x系列（比如mongoose@4.13.21）
• 降级connect-mongo到v1.x系列（比如connect-mongo@1.3.2）
  执行命令：

npm uninstall mongoose connect-mongo
npm install mongoose@4.13.21 connect-mongo@1.3.2

额外优化建议 #

• 不要硬编码secret，用环境变量（比如process.env.SESSION_SECRET），更安全
• 开启cookie.maxAge配置，确保session过期时间和clear_interval一致
• 始终为Promise添加catch处理，避免未处理的拒绝

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