Mongoose文档中间件在MongoDB Compass删除时失效及remove方法报错问题

一、MongoDB Compass删除文档无法触发Mongoose中间件 #

原因 #

Mongoose中间件是基于自身驱动层实现的，只有通过Mongoose提供的方法（如doc.deleteOne()、Model.deleteOne()）执行操作时才会触发。而MongoDB Compass是直接连接MongoDB原生实例执行删除命令，完全绕开了Mongoose的中间件逻辑，自然不会触发。

解决办法 #

• 统一通过应用接口删除：所有Class文档的删除操作都通过你的应用代码调用Mongoose的删除方法（deleteOne/deleteMany），确保中间件执行。
• 使用MongoDB原生触发器：如果必须支持Compass直接删除，可在MongoDB中创建Change Streams监听Class集合的删除事件，在事件回调中执行关联数据的清理逻辑（需要MongoDB 3.6+版本支持）。

二、remove方法触发TypeScript类型错误 #

原因 #

Mongoose从v5版本开始就废弃了remove()方法，官方推荐使用deleteOne()/deleteMany()替代，同时TypeScript的类型定义文件中已经移除了remove作为合法的中间件事件名，所以VSCode会抛出类型不匹配的错误。

解决办法 #

1. 替换为deleteOne/deleteMany中间件：继续使用你当前的deleteOne中间件，若需要覆盖查询级删除（比如通过ClassModel.deleteOne({_id: id})触发），调整中间件配置：

// 同时支持文档级和查询级删除的中间件
classSchema.post<ClassInterface>('deleteOne', { document: true, query: true }, async function(doc) {
  // 区分文档级和查询级：query模式下doc为null，需要从查询条件获取文档
  const classItem = doc || await this.model.findOne(this.getQuery());
  if (!classItem) return;

  const Event = model('Event');
  const Shift = model('Shift');
  const Subscription = model('Subscription');
  try {
    const events = await Event.find({ class: classItem._id });
    for (const event of events) {
      await Shift.deleteMany({ _id: { $in: event.shifts } });
    }
    await Event.deleteMany({ class: classItem._id });
    await Subscription.updateMany(
      { classes: classItem._id },
      { $pull: { classes: classItem._id } }
    );
  } catch (error: any) {
    console.error('Error deleting related documents:', error);
  }
});

2. 彻底移除remove相关代码：检查项目中所有使用remove()的地方，替换为deleteOne()或deleteMany()，避免类型错误和废弃方法的警告。

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