TypeORM一对多关联绑定后Friend实体target字段异常变更求助

问题根源 #

你遇到的Friend.target字段被覆盖的问题，核心是实体关联的映射逻辑错误：

在当前设计中：

• User.friends是@OneToMany(() => Friend, (friend) => friend.target)，表示User的friends集合关联的是Friend实体的target字段
• Friend.target是@ManyToOne(() => User, (user) => user.friends)，表示Friend的target字段反向关联到User.friends

这种映射意味着：Friend实体的target字段就是拥有该Friend记录的用户。所以当你通过QueryBuilder.relation或user.friends.push()将Friend添加到某个User的friends集合时，TypeORM会自动将该Friend的target更新为这个User，直接覆盖你之前设置的目标用户值，导致好友列表查询错误。

正确解决方案 #

需要重新设计实体关联，明确Friend记录的归属者和目标好友：

1. 修改Friend实体 #

新增owner字段表示该好友记录属于哪个用户，target字段表示对应的好友用户：

@Entity()
export class Friend {
  @PrimaryGeneratedColumn('uuid')
  public id!: string;

  // 好友记录的归属者（即当前用户）
  @ManyToOne(() => User, (user) => user.friends)
  public owner!: User;

  // 目标好友用户
  @ManyToOne(() => User)
  public target!: User;

  @OneToOne(() => FriendPreferences)
  @JoinColumn()
  public preferences!: FriendPreferences;

  @CreateDateColumn()
  public createdAt!: Date;
}

2. 修改User实体的friends关联 #

将反向关联指向Friend.owner字段：

@Entity()
export class User {
  // ... 其他字段保持不变

  // 用户的好友列表，关联Friend实体的owner字段
  @OneToMany(() => Friend, (friend) => friend.owner)
  public friends!: Friend[];

  // ... 其他关联保持不变
}

3. 修改addFriend服务逻辑 #

创建Friend记录时，明确指定owner和target，无需手动维护User.friends集合（TypeORM会自动维护外键）：

public async addFriend({ requestId }: AddFriendDto) {
  const request = await this.getFriendRequest(requestId, true);
  if (request.status !== FriendRequestStatus.ACCEPTED) {
    throw new ServiceException(
      'Friend request must be accepted to add the target user.',
      HttpStatus.FORBIDDEN,
    );
  }

  // 创建发起者到接收者的好友记录
  const senderToReceiverPrefs = await this.friendPreferencesRepository.save({
    nickname: request.senderSetNickname,
    permission: request.senderSetPermission,
  });
  await this.friendRepository.save({
    owner: request.sender,
    target: request.target,
    preferences: senderToReceiverPrefs,
  });

  // 创建接收者到发起者的好友记录
  const receiverToSenderPrefs = await this.friendPreferencesRepository.save({
    nickname: request.targetSetNickname,
    permission: request.targetSetPermission,
  });
  await this.friendRepository.save({
    owner: request.target,
    target: request.sender,
    preferences: receiverToSenderPrefs,
  });
}

验证方式 #

修改完成后，查询用户的好友列表时，只需关联friends.target即可正确获取目标好友：

const user = await this.userRepository.findOne({
  where: { id: userId },
  relations: ['friends', 'friends.target'],
});
// user.friends中的每个item的target字段就是对应的好友用户

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