本文介绍如何正确获取 mongodb 集合中文档总数，避免误用 `findone()` 导致 `nan` 错误，并演示安全、高效地实现基于计数的自增 id 逻辑。

在使用 Mongoose 构建类似“猜 Emoji”这类需唯一递增 ID 的系统时，一个常见误区是试图通过 model.findOne() 获取文档后直接调用 .length 属性来计算数量——这是错误的：findOne() 返回的是单个文档对象（或 null），而非数组，因此 data.length 恒为 undefined，参与算术运算后即得 NaN。

✅ 正确做法是使用 Mongoose 提供的聚合计数方法：

// ✅ 推荐：countDocuments() —— 安全、高效、支持查询条件
const count = await model.countDocuments(); // 返回 Promise
const newId = count + 1;

await model.create({ ID: newId });

⚠️ 注意事项：

• ❌ 避免使用已弃用的 model.count()（Mongoose 7+ 中已移除）；
• ❌ 不要使用 model.find().then(docs => docs.length)，该方式会拉取全部文档到内存，性能差且易崩溃；
• ✅ countDocuments() 底层调用 MongoDB 的 countDocuments 命令，不加载数据，仅返回匹配文档数，支持条件过滤（如 countDocuments({ status: 'active' })）；
• ⚠️ 若需严格保证 ID 全局唯一且连续（如竞赛排名），注意并发场景下 countDocuments() + create 并非原子操作，可能引发竞态（两个请求同时读到相同 count，写入重复 ID）。此时应改用 MongoDB 原生 ObjectId、$inc 更新器，或引入原子性更强的方案（如单独维护一个计数器集合 + findOneAndUpdate({ upsert: true }, { $inc: { seq: 1 } })）。

? 小结：对绝大多数“生成新 ID”的需求，await model.countDocuments() 是简洁、可靠、符合最佳实践的选择；只需确保操作在 async/await 或 .then() 异步上下文中执行即可。