如何在Mongoose中实现类似onDelete: cascade的关联文档删除？

我在项目中使用MongoDB和Mongoose ORM，有两个关联集合，Schema定义如下：

Sensor 集合 Schema #

const Sensor: Schema = new Schema(
  {
    name: {
      type: String,
    },
    description: {
      type: String,
      default: null,
    },
    deviceId: {
      type: mongoose.Types.ObjectId,
      required: true,
      ref: 'Device',
    },
  },
  {
    timestamps: true,
    versionKey: false,
    collection: 'Sensor',
  }
);

Device 集合 Schema #

const Device: Schema = new Schema(
  {
    name: {
      type: String,
      required: true,
      unique: true,
    },
  },
  {
    versionKey: false,
    collection: 'Device',
  }
);

Sensor集合通过deviceId关联Device的ID，现在需要实现删除Device时，自动删除其关联的所有Sensor，类似Sequelize/TypeORM中的onDelete: cascade特性，请问怎么用Mongoose实现？相关最佳实践是什么？

Mongoose本身没有SQL ORM那样原生的数据库级联删除，但可以通过以下几种方式实现类似效果：

1. 使用Mongoose中间件（Pre/Post Hook） #

在Device的Schema上添加预删除中间件，在删除Device前批量清理关联的Sensor。

代码示例： #

// 针对Model.deleteOne()静态方法的预删除钩子
Device.pre('deleteOne', async function(next) {
  const deviceId = this.getQuery()['_id'];
  await Sensor.deleteMany({ deviceId });
  next();
});

// 注意：remove()实例方法已废弃，不推荐使用，仅作兼容参考
Device.pre('remove', async function(next) {
  await Sensor.deleteMany({ deviceId: this._id });
  next();
});

注意：pre('remove')仅对deviceInstance.remove()实例方法生效，该方法已被标记为废弃；如果使用Model.deleteOne()/Model.deleteMany()静态方法，必须用pre('deleteOne')钩子。

2. 使用MongoDB数据库级触发器 #

如果你的MongoDB部署支持（如MongoDB Atlas），可以直接在数据库层面创建变更流触发器，实现纯数据库端的级联删除，无需在代码中处理。

大致步骤： #

• 在MongoDB控制台创建触发器，监听Device集合的delete事件
• 触发器执行逻辑：获取被删除Device的_id，执行db.Sensor.deleteMany({ deviceId: <deletedDeviceId> })

3. 业务逻辑中手动处理 #

在删除Device的统一业务方法里，先删关联Sensor再删Device：

async function deleteDevice(deviceId) {
  // 先清理关联Sensor
  await Sensor.deleteMany({ deviceId });
  // 再删除目标Device
  await Device.deleteOne({ _id: deviceId });
}

这种方式简单直接，但需要确保所有删除Device的操作都走这个统一方法，避免遗漏。

• 优先用数据库级触发器：数据库端的级联删除可靠性更高，不会因为代码层面的疏漏（比如误用未触发钩子的删除方法）导致数据不一致。
• 中间件需注意方法兼容性：明确区分静态方法和实例方法对应的钩子，避免级联逻辑失效。
• 事务保障（可选）：如果MongoDB版本支持事务（4.0+），在手动处理或中间件中使用事务，确保删除操作的原子性：

  async function deleteDeviceWithTransaction(deviceId) {
    const session = await mongoose.startSession();
    session.startTransaction();
    try {
      await Sensor.deleteMany({ deviceId }, { session });
      await Device.deleteOne({ _id: deviceId }, { session });
      await session.commitTransaction();
    } catch (err) {
      await session.abortTransaction();
      throw err;
    } finally {
      session.endSession();
    }
  }
  

• 避免大数量级联阻塞：如果关联Sensor数据量极大，批量删除可能影响性能，建议采用异步删除（如消息队列）来避免阻塞主业务流程。

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