本文详解如何通过 mongoose 中间件（pre-deleteone hook）实现带业务校验的软性删除保护，防止误删仍有关联数据（如书籍）的作者文档，并修正常见字段引用错误。
本文详解如何通过 mongoose 中间件（pre-deleteone hook）实现带业务校验的软性删除保护，防止误删仍有关联数据（如书籍）的作者文档，并修正常见字段引用错误。
在使用 Mongoose 管理 MongoDB 数据时，常需保障数据一致性——例如，不允许直接删除仍有书籍关联的作者。此时，仅靠应用层校验易被绕过，而利用 Mongoose 的 pre('deleteOne') 中间件可统一拦截并验证删除请求，实现声明式、可复用的数据完整性约束。
✅ 正确实现：使用 pre('deleteOne') 中间件
以下是在 authorSchema 上添加的安全删除钩子示例：
authorSchema.pre('deleteOne', { document: false, query: true }, async function (next) {
try {
const filter = this.getFilter(); // 获取查询条件对象
// 关键修正：MongoDB 文档主键字段名为 `_id`，不是 `id`
const authorId = filter._id;
if (!authorId) {
return next(new Error('Delete operation missing _id filter'));
}
const hasBooks = await Book.exists({ author: authorId });
if (hasBooks) {
return next(new Error('This author still has books. Cannot be deleted.'));
}
next(); // 允许执行 deleteOne
} catch (err) {
next(err);
}
});? 注意中间件配置项：{ document: false, query: true } 明确指定该钩子作用于 Query Middleware（即 Model.deleteOne() 调用），而非 Document 方法（如 doc.deleteOne()）。这是正确拦截模型级删除操作的关键。
⚠️ 常见错误与修复要点
| 错误写法 | 正确写法 | 说明 |
|---|---|---|
| query.id | query._id | MongoDB 默认主键字段是 _id（带下划线），非 id；若 Schema 中未显式定义 id: false 或重命名，务必使用 _id |
| 忽略 filter 为空校验 | 添加 if (!authorId) 检查 | 防止无明确条件的误删（如 {}）导致全量扫描或意外行为 |
| 未设置 query: true | 显式传入 middleware options | 否则默认为 document middleware，无法捕获 Model.deleteOne() 调用 |
? 补充建议：增强健壮性与可观测性
- 日志记录：在生产环境建议加入日志，例如 console.warn([AUTHOR_DELETE_BLOCKED] Author ${authorId} has ${await Book.countDocuments({ author: authorId })} books)；
- 支持 ObjectId 类型校验：若 filter._id 是字符串，可用 mongoose.Types.ObjectId.isValid(authorId) 提前过滤非法 ID；
- 考虑事务场景：若删除逻辑涉及多集合联动（如级联软删），应升级为 session 事务 + pre('deleteOne') 组合控制。
✅ 总结
Mongoose 的 pre('deleteOne') 是实施业务级删除约束的轻量高效方案。核心在于：
① 使用 query: true 确保钩子生效于模型方法；
② 从 this.getFilter() 安全提取 _id 并做有效性校验；
③ 通过关联集合（如 Book）查询验证业务规则；
④ 主动抛出错误中断操作，避免静默失败。
如此，既守住数据一致性底线，又保持接口简洁性与可维护性。
