TypeORM中update无法更新关联关系但save可行的问题排查

我尝试更新一条Order记录及其关联的Shipment数据时遇到了问题：

• 使用save方法可以成功更新：

await this.orderRepository.save(
    {
        ...orderRecord,
        orderStatus: mappedOrderStatus,
        shipments: [...orderRecord.shipments, shipment], // 追加新的shipment
    },
);

其中orderRecord的内容为：

Order {
  id: 1,
  createdAt: 2023-01-23T15:56:25.733Z,
  updatedAt: 2023-01-23T15:56:25.733Z,
  orderNumber: 174,
  shipments: [
    Shipment {
      id: 1,
      createdAt: 2023-01-23T15:56:25.433Z,
      updatedAt: 2023-01-23T15:56:25.433Z,
      orders: [Array]
    }
  ]
}

• 但使用update方法执行相同逻辑时，抛出错误：Cannot query across many-to-many for property shipments

await this.orderRepository.update(orderRecord.id, {
    orderStatus: mappedOrderStatus,
    shipments: [...orderRecord.shipments, asd],
});

相关实体定义：
order.entity.ts

@ManyToMany(() => Shipment,
    (shipment) => shipment.orders)
shipments: Shipment[]

shipment.entity.ts

@ManyToMany(() => Order,
    (order) => order.shipments,
    { cascade: true }
)
@JoinTable()
orders: Order[]

问题原因 #

TypeORM的update和save方法底层逻辑完全不同：

1. save是实体实例驱动：它会处理完整的实体对象，识别关联集合的变化，自动维护多对多中间表的增删操作，所以你的代码能正常工作。
2. update是直接生成SQL的UPDATE语句：仅支持更新实体自身的基础属性（如orderStatus），无法直接操作多对多关联关系——多对多关联需要修改中间表，而update不支持这种跨表操作，因此抛出报错。

解决方案 #

方案1：继续使用save方法 #

这是最简便的方式，你的现有代码已经验证可行，save天然支持关联关系的级联修改。

方案2：手动维护关联关系 #

如果偏好分步骤操作，可以分开处理属性更新和关联维护：

1. 更新实体自身属性：

await this.orderRepository.update(orderRecord.id, {
    orderStatus: mappedOrderStatus,
});

2. 新增多对多关联：

// 新增单个关联
await this.orderRepository
  .createQueryBuilder()
  .relation(Order, "shipments")
  .of(orderRecord.id)
  .add(shipment);

// 批量新增关联（如果需要）
await this.orderRepository
  .createQueryBuilder()
  .relation(Order, "shipments")
  .of(orderRecord.id)
  .add([...orderRecord.shipments, shipment]);

额外提示 #

你在Shipment实体中配置了{ cascade: true }，但该级联规则是从Shipment指向Order的，对Order侧发起的关联修改不生效。若需要从Order侧级联维护Shipment，需在Order实体的@ManyToMany装饰器中也添加cascade配置，例如：

@ManyToMany(() => Shipment,
    (shipment) => shipment.orders,
    { cascade: ["insert", "update"] }
)
shipments: Shipment[]

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