如何用TypeORM的relations属性实现深度关联查询？

当然可以用relations属性实现多层关联加载，不需要依赖QueryBuilder。以下是具体实现方式和常见问题排查：

正确的多层关联写法 #

TypeORM的relations支持字符串点语法（全版本兼容）和对象嵌套语法（TypeORM 0.3.x+支持），两种写法都能实现你要的Order→Orderposition→Article→Supplier层级加载：

方式1：字符串点语法（兼容所有TypeORM版本） #

const targetOrder = await this.orderRepository.findOne({
  where: { id: 你的订单ID },
  // 按关联层级依次写出关联字段，用点连接
  relations: ['orderPositions', 'orderPositions.article', 'orderPositions.article.supplier']
});

方式2：对象嵌套语法（TypeORM 0.3.x及以上推荐） #

这种写法更直观，可读性更强：

const targetOrder = await this.orderRepository.findOne({
  where: { id: 你的订单ID },
  relations: {
    orderPositions: {
      article: {
        supplier: true // 设为true表示加载该关联
      }
    }
  }
});

常见错误排查（你组合关联出错的可能原因） #

1. 关联字段名拼写错误：必须严格对应实体类中定义的关联字段名。比如Order实体中如果用@OneToMany(() => Orderposition, op => op.order)定义的关联字段是orderPositions，就不能写成orderposition或orderItems。
2. 实体关联未正确定义：检查每个层级的关联装饰器是否配置正确：
   • Order与Orderposition：确保Order里有@OneToMany，Orderposition里有对应的@ManyToOne关联到Order
   • Orderposition与Article：同理，双向或单向关联需正确配置
   • Article与Supplier：确保存在有效的@ManyToOne或@OneToOne关联
3. TypeORM版本差异：0.2.x版本不支持对象嵌套的relations写法，只能用字符串点语法；如果你的项目是旧版本，务必使用第一种写法。

和QueryBuilder写法的效果对比 #

你原来用QueryBuilder的代码大概是这样：

const targetOrder = await this.orderRepository
  .createQueryBuilder('order')
  .leftJoinAndSelect('order.orderPositions', 'orderPositions')
  .leftJoinAndSelect('orderPositions.article', 'article')
  .leftJoinAndSelect('article.supplier', 'supplier')
  .where('order.id = :id', { id: 你的订单ID })
  .getOne();

上面两种relations写法和这段QueryBuilder代码的执行效果完全一致，都会自动生成左连接语句并加载所有层级的关联数据。

额外提示 #

如果需要对关联数据添加筛选条件（比如只加载某个供应商的Article），relations属性无法直接实现，这时还是需要结合QueryBuilder或loadRelationQueryBuilder来完成。但如果只是单纯加载全量的多层关联数据，relations是更简洁的方案。

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