TypeORM 多对多关联查询时如何级联获取关联地址的地址类型

TypeORM 的关联加载遵循显式声明原则，仅会加载查询参数中明确指定层级的关联，不会自动递归加载关联实体上配置的下级映射。哪怕Address实体已经正确配置了与AddressType的一对一关联，只要当前查询没有显式声明要加载这个二级关联，返回结果就不会包含对应的addressType字段。现有实体配置无问题，仅需调整查询时的关联加载参数即可。

实现方案 #

方案1：调整Repository查询参数（适配简单查询场景） #

无需改动实体代码，直接修改findOne方法中的relations配置，通过嵌套路径声明需要加载的关联层级即可，兼容两种写法：

• 字符串数组写法（适配所有TypeORM 0.2.x+版本）：

  async findOne(id: number): Promise<Company> {
    return this.companiesRepository.findOne(id, {
      // 依次声明两层关联：Company关联的addresses、每个address关联的addressType
      relations: ["addresses", "addresses.addressType"]
    });
  }
  

• 对象形式写法（适配TypeORM 0.3.0+版本，结构可读性更强）：

  async findOne(id: number): Promise<Company> {
    return this.companiesRepository.findOne(id, {
      relations: {
        addresses: {
          addressType: true
        }
      }
    });
  }
  

方案2：通过QueryBuilder实现（适配复杂查询场景） #

如果查询需要对关联的Address、AddressType增加筛选、排序、自定义返回字段的逻辑，可以通过leftJoinAndSelect逐级关联嵌套数据：

async findOne(id: number): Promise<Company> {
  return this.companiesRepository.createQueryBuilder("company")
    // 关联公司下的全部地址
    .leftJoinAndSelect("company.addresses", "address")
    // 关联每个地址对应的地址类型
    .leftJoinAndSelect("address.addressType", "addressType")
    .where("company.id = :id", { id })
    .getOne();
}

注意事项 #

• 实体映射无需调整：已配置的@ManyToMany多对多关联、@OneToOne一对一关联逻辑均正确，缺失字段的原因仅为查询时未声明嵌套关联层级，不属于实体配置错误。
• 优先使用leftJoin：如果存在无关联地址的公司、未绑定类型的地址这类空关联场景，使用innerJoin会直接过滤掉不匹配的主数据，不符合绝大多数业务的返回预期。

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