TypeORM+Postgres场景下更新User实体未删除已移除的关联AdminUserGroup子实体

根因说明 #

你遇到的问题是TypeORM默认未感知到关联集合的变化，触发不了子实体的删除/置空逻辑，核心有两个常见触发原因：

1. 查询父实体User时没有加载关联的userGroups集合，TypeORM不知道该用户原本存在关联子记录，自然不会执行对应操作
2. 父实体的@OneToMany配置缺失孤儿行处理规则，无法触发关联切断后的子实体操作

修复步骤 #

第一步：修改查询逻辑，加载关联集合 #

查询用户时必须显式指定加载userGroups关联，否则关联属性是未初始化状态，赋值为空数组/Null不会触发任何变更：

async updateUserAdmin(data: UpdateUserAdminDto): Promise<User> {
    // 新增relations配置，加载关联的子实体集合
    var user = await this.userRepository.findOne({
        where: { id: data.userId },
        relations: ['userGroups']
    });
  
    user.userGroups = []
    return await this.userRepository.save(user);
}

第二步：补充父实体关联配置 #

给父实体的@OneToMany注解添加orphanedRowAction: 'delete'配置，确保关联切断后自动删除孤儿子实体：

@Entity({name: 'users'})
class User implements IUser {
  @PrimaryGeneratedColumn()
    id: number

  @Column()
    companyId: number

  @Column()
    privilegeId: number

  @OneToMany(
    () => AdminUserGroup, 
    (userGroup) => userGroup.user, 
    { 
      cascade: true,
      orphanedRowAction: 'delete' // 新增此行
    })
    userGroups: AdminUserGroup[]
}

兼容方案（适配不支持orphanedRowAction的旧版本TypeORM） #

如果你的TypeORM版本低于0.3.x不支持孤儿行配置，可以手动删除关联子实体：

async updateUserAdmin(data: UpdateUserAdminDto): Promise<User> {
    const user = await this.userRepository.findOne({
        where: { id: data.userId },
        relations: ['userGroups']
    });
    // 手动删除所有关联的AdminUserGroup记录
    await this.adminUserGroupRepository.remove(user.userGroups);
    user.userGroups = [];
    return await this.userRepository.save(user);
}

可选配置：仅置空外键不删除子实体 #

如果不需要删除子实体，只需要清空关联外键，修改子实体的@ManyToOne配置即可：

@ManyToOne(
  () => User, 
  (user) => user.userGroups, 
  { 
    nullable: true, // 允许外键为Null
    orphanedRowAction: 'nullify' 
  }
)
@JoinColumn({ onDelete: 'SET NULL' })
user: User | null;

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