Mongoose操作DocumentDB报too many cursors错 查询后如何关闭游标

可以通过Mongoose侧配置+规范写法彻底解决DocumentDB游标数超限问题。AWS DocumentDB单实例单连接默认游标上限为10个，该报错本质是代码中存在未正常释放的泄漏游标，不是Mongoose本身的默认机制缺陷。

• 未主动调用.cursor()的普通Mongoose查询（find/findOne/aggregate等），会在结果集全部返回给客户端后自动关闭游标，正常场景不会泄漏
• 90%以上的游标泄漏来自三类场景：主动使用流式游标后未显式关闭、请求中途中断导致查询未执行完成残留游标、手动开启noCursorTimeout导致数据库侧自动回收机制失效

1. 连接初始化全局配置 #

在Mongoose连接初始化时添加如下配置，从驱动层开启空闲游标自动回收：

import mongoose from 'mongoose';

await mongoose.connect(process.env.DOCUMENTDB_CONN_URI, {
  connectTimeoutMS: 10000,
  socketTimeoutMS: 30000,
  maxIdleTimeMS: 15000, // 空闲超过15秒的连接自动回收，连带释放其上挂载的未关闭游标
  autoCreate: false,
  autoIndex: false, // 生产环境建议关闭自动建索引，避免意外长查询占游标
});

2. 显式使用游标场景必须手动兜底关闭 #

凡是主动调用.cursor()做批量流式处理的逻辑，必须加finally块兜底关闭游标，避免流程中途报错、跳出时游标残留：

import type { Cursor } from 'mongoose';

let docCursor: Cursor | null = null;
try {
  docCursor = YourModel.find({ /* 查询条件 */ }).cursor();
  for await (const doc of docCursor) {
    // 单条文档处理逻辑
    await processSingleDoc(doc);
  }
} catch (err) {
  // 自定义错误处理
  throw err;
} finally {
  // 无论流程成功、报错、提前跳出，都强制关闭游标
  if (docCursor) await docCursor.close();
}

注意：严禁在非必要场景给游标加.noCursorTimeout()配置，该配置会让游标永久跳过数据库侧的超时回收，只要代码漏关就会永久占用游标配额。

3. 补全Express请求中断的兜底逻辑 #

最容易被忽略的泄漏场景：客户端主动断开HTTP请求时，Express默认不会终止正在执行的Mongoose查询，对应游标会一直挂载到socket超时才会被回收，高并发下很容易打满10个配额。
添加全局中间件处理该场景：

import express from 'express';
const app = express();

app.use((req, res, next) => {
  const QUERY_MAX_TIMEOUT = 20000;
  // 给所有查询统一加最大执行时长，超时自动终止释放游标
  mongoose.set('maxTimeMS', QUERY_MAX_TIMEOUT);
  // 客户端主动断开连接时，终止当前连接上所有未完成的查询
  req.on('close', () => {
    mongoose.connection.db?.command({
      killCursors: "*",
      cursors: []
    }).catch(() => {});
  });
  next();
});

修复完成后，可以在DocumentDB实例上执行如下命令查看当前活跃游标数，正常流量下所有请求处理完成后，活跃游标数应回落至0，无长期残留：

db.currentOp({
  "cursor.origin": "MongoDB Driver",
  "active": true
})

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