MongoDB 排序超出内存限制 — 需要 allowDiskUse

症状

错误“MongoDB 排序超出内存限制 — 需要 allowDiskUse”指向一个明确的失效模式。下面依次给出症状、定位该原因的检查命令、根本原因、修复方案，以及证明修复有效的验证步骤。

可观察到的症状包括：

• MongoServerError: 排序超出 104857600 字节的内存限制
• 大集合上的聚合或查找带排序失败
• 同一查询在小数据集上可用

诊断

先在隔离环境中复现故障，再按顺序执行以下检查，逐步缩小范围。

步骤 1

mongosh --eval "db.orders.aggregate([{ $sort: { total: -1 } }]).toArray()"

错误会指出排序阶段与字节上限，确认是内存排序。

步骤 2

mongosh --eval "db.orders.find({}).sort({ total: -1 }).explain('executionStats').queryPlanner.winningPlan"

出现 SORT 阶段（而非索引扫描）即表明排序未被索引覆盖。

常见诱因（按出现频率排序）：

• 排序无法使用索引，在内存中执行并超过 100MB 限制
• 阻塞阶段（如 $group）位于 $sort 之前，使索引失效
• 结果集本身很大且无索引支撑

根因

当无索引可提供顺序时，MongoDB 在内存中执行排序，超过内部 100MB 上限即中止。当前置阻塞阶段或排序字段无索引时尤为常见。

修复

为该操作启用 allowDiskUse(true)，创建前缀匹配排序键的索引，把 $match/$sort 移到 $group 之前，并用 $limit 缩小结果集。

注意：allowDiskUse 以磁盘 I/O 换内存并拖慢查询；应作为补齐正确索引前的权宜之计。

// allow disk use as a stopgap
const results = await db.collection('orders')
  .aggregate([{ $sort: { total: -1 } }, { $limit: 1000 }], { allowDiskUse: true })
  .toArray();

// the real fix: index supporting the sort, and limit the set
db.orders.createIndex({ total: -1, _id: -1 });

// push $match/$sort before $group when possible
db.orders.aggregate([
  { $match: { status: 'paid' } },
  { $sort: { total: -1 } },
  { $limit: 1000 }
]);

验证

重跑查询并确认完成；验证胜出计划使用 IXSCAN 且无 SORT 阶段。

修复后补充一条回归测试，复现原始症状，防止问题再次出现。

这类故障通常是环境问题而非纯逻辑错误，因此在缺陷记录中应写明完整命令、环境变量与工作目录。请用最小的脚本复现，待最小用例清楚后再扩大范围。为这类故障准备一份简短的排查清单，能显著减少下次排障时间。