Mongoose 6.x 在 AWS Lambda 中的连接管理问题解析

问题背景

在使用 Mongoose 6.12.8 版本与 Node.js 18.20.2 组合部署到 AWS Lambda 环境时，开发团队遇到了一个棘手的数据库连接问题。当 Lambda 函数在首次成功执行后，若间隔 2-5 分钟再次触发，会出现意外的连接中断现象，导致整个 Lambda 实例崩溃重启。

现象表现

系统日志显示以下典型错误序列：

1. 首先记录 'disconnected' 事件
2. 随后触发 'error' 事件
3. 最终抛出未处理的 Promise 拒绝错误 'mongoServerSelectionError'

这些错误都发生在同一个 Lambda 调用的上下文中，但会导致后续调用需要重新初始化整个 Lambda 实例。

技术分析

深入追踪发现问题根源在于 Mongoose 6.x 版本中连接处理的逻辑变更。在 connections.js 文件的第 825 行附近，当捕获到 MongoServerSelectionError 错误时，代码会强制抛出异常：

const serverSelectionError = new ServerSelectionError();
this.$initialConnection = promise
  .then(() => this)
  .catch(err => {
    this.readyState = STATES.disconnected;
    if (err != null && err.name === 'MongoServerSelectionError') {
      err = serverSelectionError.assimilaateError(err);
    }
    if (this.listeners('error').length > 0) {
      immediate(() => this.emit('error', err));
    }
    throw err; // 这里强制抛出异常导致问题
  });

解决方案

团队发现问题的根本原因是代码中直接使用 createConnection 方法而没有正确处理其返回的 Promise。在 Mongoose 6.x 中，连接创建行为变得更加严格，必须显式处理 Promise 或使用 asPromise 方法。

修正后的最佳实践方式应为：

// 正确的连接创建方式
const connection = await mongoose.createConnection(connectionString, {
    maxPoolSize: 2,
    minPoolSize: 1,
    connectTimeoutMS: 300000,
    socketTimeoutMS: 7200000
}).asPromise(); // 关键变更点

经验总结

1. 版本升级注意事项：从 Mongoose 5.x 升级到 6.x 时，连接管理机制有显著变化，需要仔细检查所有连接创建代码

2. Lambda 环境特殊性：在无服务器环境中，连接池管理需要特别关注，建议：

   • 设置合理的连接池大小
   • 配置适当的超时参数
   • 实现完善的错误处理机制

3. Promise 处理：所有异步操作都应妥善处理 Promise，避免未捕获的异常

4. 监控建议：在 Lambda 环境中部署时，建议增加对以下指标的监控：

   • 连接建立成功率
   • 连接中断频率
   • 连接池使用情况

通过以上调整，团队成功解决了在 AWS Lambda 环境中使用 Mongoose 6.x 的连接稳定性问题，为类似场景的开发提供了有价值的参考经验。