TypeORM：从父实体移除时能否级联软删除子实体？

默认情况下，当你从父实体的OneToMany集合中移除子实体并保存父实体时，TypeORM会将子实体的外键（parentId）设为NULL——这是框架默认的关联更新逻辑，仅维护外键关系而非触发软删除。要实现移除时自动软删除子实体，可通过以下几种方式实现：

方法一：手动软删除子实体（最直接可控） #

先定位要移除的子实体，手动触发软删除，再从父实体的子集合中移除并保存父实体：

// 1. 查询父实体并关联子实体
const parent = await this.parentRepository.findOne({
  where: { id: targetParentId },
  relations: ['childrenEntities']
});

if (!parent) {
  throw new Error('父实体不存在');
}

// 2. 获取要移除的子实体（示例取第一个）
const childToRemove = parent.childrenEntities[0];

// 3. 软删除子实体（两种方式二选一）
// 方式A：使用TypeORM内置的softDelete方法
await this.childRepository.softDelete(childToRemove.id);

// 方式B：手动设置deletedAt字段后保存
// childToRemove.deletedAt = new Date();
// await this.childRepository.save(childToRemove);

// 4. 从父实体的子集合中移除该子实体
parent.childrenEntities = parent.childrenEntities.filter(child => child.id !== childToRemove.id);

// 5. 保存父实体
await this.parentRepository.save(parent);

这种方式完全由开发者控制逻辑，适合需要额外业务判断的场景。

方法二：利用实体事件自动触发软删除 #

通过TypeORM的实体生命周期事件，在子实体的parentEntity被设为NULL时自动设置deletedAt字段：

修改ChildEntity，添加@BeforeUpdate监听器：

class ChildEntity {
  @ManyToOne(() => ParentEntity, (pe) => pe.childrenEntities)
  parentEntity: ParentEntity;

  @DeleteDateColumn()
  deletedAt?: Date;

  @BeforeUpdate()
  handleParentRemoval() {
    // 仅当parentEntity被清空且未被软删除时，触发软删除
    if (!this.parentEntity && !this.deletedAt) {
      this.deletedAt = new Date();
    }
  }
}

之后你原来的操作流程无需修改：

const parent = await this.parentRepository.findOne({
  where: { id: targetParentId },
  relations: ['childrenEntities']
});

parent.childrenEntities.splice(0, 1);
await this.parentRepository.save(parent);

此时TypeORM更新子实体的parentId为NULL时，会触发@BeforeUpdate事件，自动设置deletedAt字段完成软删除。

注意：如果业务中存在需要将parentId设为NULL但不软删除的场景，需修改监听器的判断逻辑，避免误触发。

方法三：自定义Repository封装逻辑 #

将软删除+移除关联的逻辑封装到父实体的Repository中，简化调用：

@EntityRepository(ParentEntity)
export class ParentRepository extends Repository<ParentEntity> {
  async removeChildSoftly(parentId: number, childId: number): Promise<ParentEntity> {
    const parent = await this.findOne({
      where: { id: parentId },
      relations: ['childrenEntities']
    });

    if (!parent) throw new Error('父实体不存在');

    const childToRemove = parent.childrenEntities.find(child => child.id === childId);
    if (!childToRemove) throw new Error('子实体不存在');

    // 软删除子实体
    await this.manager.getRepository(ChildEntity).softDelete(childId);

    // 移除关联
    parent.childrenEntities = parent.childrenEntities.filter(child => child.id !== childId);

    return this.save(parent);
  }
}

调用时只需：

await this.parentRepository.removeChildSoftly(parentId, childId);

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