NestJS中TypeORM一对多关联级联更新失效问题排查

问题背景 #

实体定义 #

Sports表实体：

// Sports表实体
@Entity({name: 'Sports'})
export class Sports {
  @PrimaryGeneratedColumn()
  id!: number;

  @Column()
  name!: string;

  @OneToMany(() => Tennis, (tennis) => tennis.sport, {cascade: true})
  tennis!: Tennis[];
}

Tennis表实体：

// Tennis表实体
@Entity({name: 'Tennis'})
export class Tennis {
  @PrimaryGeneratedColumn()
  id!: number;

  @Column()
  sportsId!: number

  @Column()
  racketBrand!: string;

  @ManyToOne(() => Sports, (sport) => sport.tennis, {
    onDelete: 'CASCADE',
    onUpdate: 'CASCADE',
  })
  sport!: Sports;
}

更新逻辑代码（sports.service.ts） #

public async update(id: number, updateSportsDto: UpdateSportsDto) {
    return this.sportsRepository.save({id, ...updateSportsDto}).then(() => {
      return this.sportsRepository.findOneOrFail({
        where: {id},
        relations: ['sports', 'sports.tennis'],
      });
    });
}

报错信息 #

执行PATCH /sports/:id更新请求时，出现错误：

"message": "null value in column \"sports_id\" of relation \"tennis\" violates not-null constraint",

已知可成功执行级联插入，但级联更新存在问题，需确保sports_id从Sports表传递到Tennis表。

问题原因及解决方法 #

1. 移除手动维护的sportsId字段 #

Tennis实体中同时定义sportsId和关联对象sport会导致字段不一致，TypeORM会自动处理外键列，无需手动定义。修改后的Tennis实体：

// Tennis表实体
@Entity({name: 'Tennis'})
export class Tennis {
  @PrimaryGeneratedColumn()
  id!: number;

  @Column()
  racketBrand!: string;

  @ManyToOne(() => Sports, (sport) => sport.tennis, {
    onDelete: 'CASCADE',
    onUpdate: 'CASCADE',
    nullable: false // 显式设置非空，避免约束问题
  })
  sport!: Sports;
}

2. 修正更新逻辑中的查询与保存方式 #

直接使用save({id, ...updateSportsDto})会创建新实体实例，丢失关联的Tennis数据，导致外键为空。正确做法是先查询现有实体，合并更新后再保存：

public async update(id: number, updateSportsDto: UpdateSportsDto) {
    // 查询带关联数据的目标实体
    const sport = await this.sportsRepository.findOneOrFail({
      where: {id},
      relations: ['tennis']
    });
    
    // 合并更新字段到现有实体
    Object.assign(sport, updateSportsDto);
    
    // 保存实体，自动级联处理关联的Tennis数据
    await this.sportsRepository.save(sport);
    
    // 返回更新后的完整数据
    return this.sportsRepository.findOneOrFail({
      where: {id},
      relations: ['tennis']
    });
}

同时修正查询的relations参数，原代码中['sports', 'sports.tennis']是错误的，应直接关联tennis。

3. 确保UpdateSportsDto结构合法 #

如果UpdateSportsDto包含tennis数组的更新，需保证每个tennis对象要么包含id（用于更新现有记录），要么包含完整属性（用于新增记录），无需手动设置sport关联，TypeORM会自动维护外键。

内容的提问来源于stack exchange，提问作者s.k