Typeorm多对多关联更新时旧数据被误删问题求助

问题重现 #

使用带中间表的ManyToMany关联时，首次保存正常，但更新时原本的关联会被删除：将failedDestVhosts从[VHost1, VHost2]更新为[VHost1, VHost2, VHost3, VHost4]后，TypeORM会插入VHost3、VHost4的关联，随后删除VHost1、VHost2的关联，最终仅保留新添加的两个关联。

核心原因 #

TypeORM对未托管实体数组的全量替换，无法识别原有关联的有效性（比如实体未加载主键、未被EntityManager管理），默认会先清除所有旧关联，再插入新数组中的关联。

解决方案 #

1. 增量更新关联（推荐） #

查询目标Migration实体并加载现有关联，直接在原数组上添加新VHost实例，TypeORM会自动新增关联记录，不会删除原有数据。

示例代码：

// 1. 查询Migration并加载已关联的VHost
const migration = await migrationRepository.findOne({
  where: { migrationId: "你的迁移ID" },
  relations: ['failedDestVhosts']
});

// 2. 获取需要新增的VHost实例（从数据库查询确保实体已托管）
const vhost3 = await vhostRepository.findOneBy({ vHostId: "V3的ID" });
const vhost4 = await vhostRepository.findOneBy({ vHostId: "V4的ID" });

// 3. 添加新关联并保存
migration.failedDestVhosts.push(vhost3, vhost4);
await migrationRepository.save(migration);

2. 全量替换数组时确保实体被正确托管 #

如果必须替换整个关联数组，需保证数组中每个VHost实例都包含有效主键，且是从数据库查询得到的托管实体（或通过repository.create/manager.merge创建的托管对象）。

示例代码：

// 1. 查询所有需要关联的VHost实例
const vhost1 = await vhostRepository.findOneBy({ vHostId: "V1的ID" });
const vhost2 = await vhostRepository.findOneBy({ vHostId: "V2的ID" });
const vhost3 = await vhostRepository.findOneBy({ vHostId: "V3的ID" });
const vhost4 = await vhostRepository.findOneBy({ vHostId: "V4的ID" });

// 2. 查询目标Migration实体
const migration = await migrationRepository.findOneBy({ migrationId: "你的迁移ID" });

// 3. 替换关联数组并保存
migration.failedDestVhosts = [vhost1, vhost2, vhost3, vhost4];
await migrationRepository.save(migration);

3. 调整cascade配置 #

如果VHost实体已预先存在于数据库中，建议移除cascade: true，避免TypeORM误操作VHost实体，减少不必要的数据库交互：

export class Migration {
  @Column({ name: 'migration_id', type: 'uuid' })
  migrationId: string;

  @ManyToMany(() => VHost, { eager: true })
  @JoinTable({
    name: 'instance_failed_vhost',
    joinColumn: { name: 'migration_id', referencedColumnName: 'migrationId' },
    inverseJoinColumn: {
      name: 'dest_vhost_id',
      referencedColumnName: 'vHostId',
    },
  })
  failedDestVhosts: VHost[];
}

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