TypeORM中如何在实体类中默认关联查询user.username字段？

问题背景 #

现有如下TypeORM实体定义：

@Entity('element')
export class Element {
  [...]
  
  @ManyToOne(() => User, (user) => user.createdElements)
  createdBy: User;
}

@Entity('user')
export class User {
  [...]
  
  @Column()
  username: string;

  @OneToMany(() => Element, (element) => element.createdBy)
  createdElements: Element[];
}

当前通过QueryBuilder可实现查询Element时加载关联的createdBy.username：

this.elementRepository.createQueryBuilder('element')
  .leftJoin('element.createdBy', 'user')
  .addSelect('user.username')
  .getMany()

希望在实体层面配置，让该字段默认被查询，无需每次编写QueryBuilder逻辑。

可行方案 #

1. 使用eager加载（加载完整关联实体） #

如果接受默认加载整个User实体（而非仅username），可给@ManyToOne装饰器添加eager: true配置：

@ManyToOne(() => User, (user) => user.createdElements, { eager: true })
createdBy: User;

• 效果：每次查询Element时，TypeORM会自动左连接并加载完整的createdBy用户对象，包含所有字段。
• 局限：无法仅加载username单个字段，会加载User的全部属性，适合需要完整用户信息的场景。

2. 自定义Repository封装查询逻辑（推荐，精准加载指定字段） #

TypeORM不支持直接在实体中配置“仅加载关联实体的某个字段”作为默认行为，但可通过自定义Repository封装通用查询逻辑，实现类似“默认加载”的效果：

import { Repository, EntityRepository } from "typeorm";
import { Element } from "./element.entity";

@EntityRepository(Element)
export class ElementRepository extends Repository<Element> {
  // 封装默认查询方法，自动加载createdBy.username
  findAll() {
    return this.createQueryBuilder('element')
      .leftJoin('element.createdBy', 'user')
      .addSelect('user.username')
      .getMany();
  }

  // 封装单条查询方法
  findOneById(id: number) {
    return this.createQueryBuilder('element')
      .leftJoin('element.createdBy', 'user')
      .addSelect('user.username')
      .where('element.id = :id', { id })
      .getOne();
  }
}

• 使用方式：业务代码中直接调用自定义仓库的findAll()或findOneById()，无需重复编写QueryBuilder逻辑。
• 优势：精准控制加载的字段，避免冗余数据，同时统一查询逻辑。

补充说明 #

TypeORM目前没有提供在实体注解中直接指定“关联实体部分字段默认加载”的配置项，因此上述两种方案是最常用的实现方式。如果仅需要username字段，自定义Repository是更贴合需求的选择。

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