无装饰器模式下用原生JS实现TypeORM双向一对一关联queryBuilder联查报错求助

• 你的场景里外键存储在VehicleAttribute表，两个实体的schema配置要严格按照外键持有方/反向端的规则区分参数，不能照搬装饰器的配置逻辑
  • 外键持有方（VehicleAttribute）的relations配置必须包含joinColumn声明，示例代码：

  // VehicleAttributeSchema 的关系定义
  relations: {
    vehicle: {
      target: 'Vehicle',
      type: 'one-to-one',
      joinColumn: {
        name: 'vehicle_id', // 数据库中实际的外键列名
        referencedColumnName: 'id' // 关联到Vehicle表的主键列
      },
      inverseSide: 'attributes' // 指向Vehicle实体中对应的反向关联字段名
    }
  }
  

  • 反向关联端（Vehicle）的relations配置禁止配置joinColumn，否则会触发关联列不存在的报错，示例代码：

  // VehicleSchema 的关系定义
  relations: {
    attributes: {
      target: 'VehicleAttribute',
      type: 'one-to-one',
      inverseSide: 'vehicle' // 指回VehicleAttribute实体中的关联字段名
    }
  }
  

报错根因说明 #

这个报错的触发逻辑非常直接：只要TypeORM在Vehicle实体的关联配置里检测到joinColumn参数，就会默认Vehicle是外键持有方，自动去vehicles表里找对应的外键列。但你的场景里外键是存在vehicle_attributes表里的，vehicles表根本没有这个列，自然会抛出列不存在的错误。

QueryBuilder的正确使用方式 #

• 你之前编写的联查代码逻辑本身没有问题，只要schema配置修正后，以下代码可正常执行：

  const vehicleRepository = dataSource.getRepository('Vehicle');
  const vehicleList = await vehicleRepository.createQueryBuilder('i')
    .innerJoinAndSelect('i.attributes', 'attributes')
    .getMany();
  

  TypeORM会自动根据双向关联的配置，生成正确的联表SQL，无需手动追加关联条件。

原生JS schema定义的常见避坑点 #

• 双向一对一关联中，仅外键实际存储的一方可以配置joinColumn，两个实体同时配置会触发关联逻辑冲突
• 关系配置中的inverseSide值必须和对方实体的关联字段名完全匹配，拼写错误会直接导致关联关系解析失败
• 关系类型的type字段值必须和实际业务关系一致，反向端也要设置为'one-to-one'，不能因为是反向查询就改成'many-to-one'，否则会导致关联结果被识别为数组，和一对一的业务预期不符

内容的提问来源于stack exchange，提问作者Roxnny A Barrios C