TypeORM如何无需加载完整OneToMany关联集合即可插入子实体

核心实现思路 #

事务发件箱这类仅需追加子实体的场景，完全不需要操作父实体的子集合属性，也不需要启用级联配置，只要显式操作子实体的外键字段，配合事务保证原子性即可，全程不会触发孤儿删除逻辑，也不需要加载任何历史子实体数据。

孤儿删除触发的前置条件是父实体对象的子集合属性被主动修改（比如加载父实体时没有关联子集合，导致子集合属性为空，后续save父实体时TypeORM会判定所有原有子实体被移除），只要避免操作父实体的子集合属性、不整体save未包含完整子集合的父实体对象，即可完全规避该问题。

代码示例 #

实体定义 #

首先在子实体中显式声明外键字段，避免仅依赖关联对象操作：

import { Entity, PrimaryGeneratedColumn, Column, OneToMany, ManyToOne, JoinColumn } from "typeorm";

// 父实体示例：业务订单
@Entity()
export class Order {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  status: string;

  @OneToMany(() => DomainEvent, event => event.order, {
    // 无需开启级联，避免误操作
    orphanedRowAction: "nullify" // 非必要不设置为delete，避免误删历史子实体
  })
  events: DomainEvent[];
}

// 子实体示例：领域事件（发件箱存储载体）
@Entity()
export class DomainEvent {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  eventName: string;

  @Column("text")
  payload: string;

  @ManyToOne(() => Order, order => order.events)
  @JoinColumn()
  order: Order;

  // 显式声明外键字段，用于直接赋值
  @Column()
  orderId: number;
}

原子操作示例（更新父实体+追加子事件） #

使用事务包裹两个独立操作，全程不需要加载父实体的子集合：

import { getManager } from "typeorm";

async function orderPaidOperate(orderId: number, eventPayload: Record<string, any>) {
  await getManager().transaction(async transactionalManager => {
    // 仅更新父实体需要修改的字段，不用查询父实体、不用加载子集合
    await transactionalManager.update(Order, orderId, {
      status: "PAID"
    });

    // 直接插入子事件，仅需赋值父实体ID即可完成关联
    await transactionalManager.insert(DomainEvent, {
      eventName: "OrderPaid",
      payload: JSON.stringify(eventPayload),
      orderId: orderId
    });
  });
}

注意事项 #

• 不要整体save未加载完整子集合的父实体对象，优先使用update方法指定需要修改的字段，避免TypeORM误判子集合被清空
• 子实体显式声明外键字段后，所有关联操作都可以直接通过外键赋值完成，不需要实例化父实体对象
• 级联配置仅适用于子集合体量小、需要全量覆盖更新的场景，仅追加子实体的场景不需要开启任何级联

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