NestJS+TypeORM：查询主实体全字段与关联实体指定字段并扁平化结果

方法1：使用QueryBuilder直接构造扁平字段查询 #

这是最直接的方案，通过QueryBuilder手动指定返回字段，将关联表的字段重命名为扁平形式，用getRawMany()返回原始结果：

// 在UserService中实现
async getUsersWithFlatUserType() {
  return this.userRepository
    .createQueryBuilder('user')
    // 关联UserType（对应Order实体），需确保User实体中关联字段名为userType
    .leftJoin('user.userType', 'usertype')
    // 选择User所有字段（也可逐个列出以精准控制），同时重命名关联表字段
    .select([
      'user.*', // 快速选择User所有字段，兼容MySQL/PostgreSQL等主流数据库
      'usertype.id AS userTypeId',
      'usertype.value AS userTypeValue'
    ])
    // 返回原始扁平结构的结果
    .getRawMany();
}

• 若需严格控制返回字段，建议逐个列出User的字段（如user.id, user.name），避免返回冗余数据。
• getRawMany()直接返回数据库查询的原始键值对，无需映射为实体类，天然生成扁平结构。

方法2：通过DTO转换嵌套结果（类型友好） #

如果需要类型安全的返回值，可以定义DTO类，将查询到的嵌套实体转换为扁平结构，完全不需要修改User实体：

步骤1：定义返回DTO #

// user-response.dto.ts
export class UserResponseDTO {
  id: number;
  name: string;
  email: string;
  // 添加User实体的所有其他字段
  userTypeId?: number;
  userTypeValue?: string;

  constructor(user: User) {
    // 复制User的所有字段
    Object.assign(this, user);
    // 处理关联字段的扁平化
    if (user.userType) {
      this.userTypeId = user.userType.id;
      this.userTypeValue = user.userType.value;
      // 可选：删除原嵌套字段
      delete (this as any).userType;
    }
  }
}

步骤2：在Service中查询并转换 #

// UserService
async getUsers(): Promise<UserResponseDTO[]> {
  // 查询带关联的User数据
  const users = await this.userRepository.find({
    relations: ['userType']
  });
  // 转换为扁平DTO
  return users.map(user => new UserResponseDTO(user));
}

• 该方案保留了类型检查，适合需要严格类型约束的场景，且完全不改动User实体的定义。

前置关联配置检查 #

确保User实体中已正确定义与Order（usertype表）的多对一关联：

// User实体
@Entity()
export class User {
  // ... 其他字段
  @ManyToOne(() => Order)
  @JoinColumn({ name: 'user_type_id' }) // 对应数据库外键字段
  userType: Order;
}

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