使用NestJS与TypeORM时数据不一致：分页限制返回结果异常

问题根源 #

你遇到的问题是多对多关联查询产生的笛卡尔积导致LIMIT作用于关联后的总记录数，而非用户实体数量。

当你关联user.positions和user.pivot时，每个拥有多个职位的用户会在SQL查询结果中生成多条重复的用户记录（对应不同的职位关联）。设置LIMIT 10会截取前10条关联后的记录，TypeORM再将这些记录合并为用户实体，最终返回的用户数量自然会少于10（比如2个用户各占2条关联记录，LIMIT 3只会返回这2个用户）。

解决方案 #

方案1：先分页获取用户ID，再关联查询详情（推荐） #

通过子查询先从用户表中取出10个用户的ID，再基于这些ID查询关联数据，确保最终返回10个用户实体。

修改后的查询代码：

async getUsers(session: SessionPayload) {
  // 第一步：获取分页后的用户ID列表
  const userIds = await this.user
    .createQueryBuilder('user')
    .select('user.id')
    .orderBy('user.id', 'ASC')
    .limit(10)
    .getRawMany()
    .then(rows => rows.map(row => row.user_id)); // 注意：字段名需根据实际表结构调整，可能是`user_id`或`id`

  // 第二步：根据ID查询用户及关联数据
  const users = await this.user
    .createQueryBuilder('user')
    .innerJoinAndSelect('user.positions', 'pos')
    .leftJoinAndSelect('pos.organization', 'org')
    .leftJoinAndSelect('pos.department_org', 'dorg')
    .leftJoinAndSelect('user.pivot', 'piv')
    .where('user.id IN (:...userIds)', { userIds })
    .orderBy('user.id', 'ASC')
    .getMany();

  return users;
}

方案2：优化实体模型，避免冗余关联 #

你的实体模型存在冗余定义：User同时维护了@ManyToMany（关联Position）和@OneToMany（关联中间表PivotUserPosition），这会加重笛卡尔积的问题。

场景A：不需要操作中间表的额外字段

直接保留多对多关系，删除冗余的pivot字段：

// user.entity.ts
@ManyToMany(() => Position, (position) => position.users)
@Field(() => [Position], { nullable: true })
@JoinTable({
  name: 'pivot_user_position',
  joinColumn: { name: 'user_nip', referencedColumnName: 'nip' },
  inverseJoinColumn: { name: 'position_id' },
})
public positions?: Position[]

// 移除以下冗余定义
// @OneToMany(() => PivotUserPosition, (user) => user.pivot)
// @Field(() => [PivotUserPosition], { nullable: true })
// public pivot?: PivotUserPosition[]

场景B：需要操作中间表的额外字段

将多对多拆分为两个一对多关系，避免重复关联：

// user.entity.ts
@OneToMany(() => PivotUserPosition, pivot => pivot.user)
@Field(() => [PivotUserPosition], { nullable: true })
public pivotUserPositions?: PivotUserPosition[]

// position.entity.ts
@OneToMany(() => PivotUserPosition, pivot => pivot.position)
@Field(() => [PivotUserPosition], { nullable: true })
public pivotUserPositions?: PivotUserPosition[]

// pivot-user-positions.entity.ts
@ManyToOne(() => User, user => user.pivotUserPositions)
@JoinColumn({ name: 'user_nip', referencedColumnName: 'nip' })
public user: User

@ManyToOne(() => Position, position => position.pivotUserPositions)
@JoinColumn({ name: 'position_id' })
public position: Position

// 移除以下冗余定义
// @ManyToOne(() => User, (user) => user.pivot)
// @JoinColumn({ name: 'user_nip', referencedColumnName: 'nip' })
// public pivot?: User

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