Mongoose 的 deleteOne 后置中间件（post('deleteOne')）默认不提供被删除的文档对象，而是返回数据库操作结果（如 { acknowledged: true, deletedCount: 1 }），若需访问原始文档，应改用 findOneAndDelete 或 removeOne 等支持文档返回的替代方法。
mongoose 的 `deleteone` 后置中间件（`post('deleteone')`）默认不提供被删除的文档对象，而是返回数据库操作结果（如 `{ acknowledged: true, deletedcount: 1 }`），若需访问原始文档，应改用 `findoneanddelete` 或 `removeone` 等支持文档返回的替代方法。
在 Mongoose 中，deleteOne 是一个纯删除操作中间件，其设计目标是高效执行 MongoDB 原生 deleteOne 命令（不返回文档）。因此，无论是否启用 { document: true } 选项，post('deleteOne') 回调中的 doc 参数始终是数据库操作响应对象（即 DeleteResult），而非被删的文档实例 —— 这与 findOneAndDelete 或 removeOne 的行为有本质区别。
✅ 正确做法：使用 findOneAndDelete 获取文档并执行后置逻辑
findOneAndDelete 不仅能原子性地查找并删除文档，还保证返回被删除的完整文档对象（含 _id、字段值等），非常适合需要审计、日志、级联清理等场景：
// 正确示例：获取并操作被删除的文档
ClubSchema.post('findOneAndDelete', function(doc) {
if (doc) {
console.log('Deleted club:', doc.name, 'ID:', doc._id);
// ✅ 此处 doc 是完整的 Mongoose 文档实例，可安全访问所有字段
// 例如：触发缓存清除、发送通知、写入审计日志等
}
});
// 调用时需显式使用 findOneAndDelete（而非 deleteOne）
await Club.findOneAndDelete({ _id: clubId });⚠️ 注意：findOneAndDelete 默认返回 null（若未找到文档），因此务必判空；同时它会自动触发 save/remove 相关中间件（如 pre('remove')），便于统一处理。
❌ 为什么 deleteOne + { document: true } 无效？
Mongoose 官方明确说明：{ document: true } 仅对 find、findOne、findOneAndUpdate 等查询类中间件生效，用于将查询结果（文档或文档数组）注入回调参数。而 deleteOne 属于写操作命令，其底层直接调用 collection.deleteOne()，MongoDB 驱动本身不返回被删文档 —— Mongoose 无法“无中生有”提供该数据。
你观察到的：
console.log(doc); // { acknowledged: true, deletedCount: 1 }
console.log(doc._id); // undefined正是此机制的直接体现。
? 替代方案对比
| 方法 | 返回值 | 是否触发 remove 中间件 | 是否支持 document: true | 适用场景 |
|---|---|---|---|---|
| deleteOne() | DeleteResult（无文档） | ❌ 否 | ❌ 无效 | 简单、高性能批量删除，无需文档上下文 |
| removeOne() | RemoveResult（仍无文档） | ✅ 是（pre('remove')/post('remove')） | ❌ 无效 | 已弃用，不推荐新项目使用 |
| findOneAndDelete() | 被删的完整文档（或 null） | ✅ 是（pre('remove')/post('remove')） | ✅ 自动生效 | ✅ 推荐：需访问文档内容的删除操作 |
? 实践建议
- 若业务逻辑依赖被删文档（如记录操作日志、同步删除关联资源），必须使用 findOneAndDelete；
- 可配合 lean() 提升性能（但会返回 Plain JS 对象，失去 Mongoose 方法）：
await Club.findOneAndDelete({ _id: clubId }).lean(); // 返回普通对象，无 .save() 等方法 - 如需严格事务保障（如删除主文档 + 清理子集合），应封装在 session.withTransaction() 中，避免竞态。
总之，理解 Mongoose 中间件的语义边界是关键：deleteOne 是“命令”，findOneAndDelete 是“带返回的原子操作”。选择正确的 API，才能让后置钩子真正发挥价值。
