NestJS中TypeORM关联查询报错：Cannot read properties of undefined (reading 'joinColumns')

你的问题出在实体关联关系的反向引用定义错误，导致TypeORM无法正确识别双向关联的映射关系，进而在构建查询时出现relation.inverseRelation为undefined的报错。

错误原因分析 #

你当前的关联装饰器第二个参数指向了实体的主键或数据库字段，而不是对应关联实体的关联属性：

• EntityAgent的@ManyToOne错误指向了EntityClient的id字段，而非agents关联属性
• EntityClient的@OneToMany错误指向了EntityAgent的id_client字段，而非client关联属性

TypeORM需要通过这个参数建立双向关联的绑定，否则无法找到反向关联的元数据，就会触发该报错。

修正后的实体代码 #

@Entity({ name: 'Agent', schema: 'dbo' })
export class EntityAgent {
  @PrimaryGeneratedColumn({ name: 'Id' })
  id: number

  @Column({ name: 'ClientId' })
  id_client: number

  // 修正：指向EntityClient的agents关联属性
  @ManyToOne(() => EntityClient, (client) => client.agents)
  @JoinColumn({ name: 'ClientId' }) // 显式指定外键列，可选但推荐
  client: Relation<EntityClient>
}

@Entity({ name: 'Client', schema: 'dbo' })
export class EntityClient {
  @PrimaryGeneratedColumn({ name: 'Id' })
  id: number

  // 修正：指向EntityAgent的client关联属性
  @OneToMany(() => EntityAgent, (agent) => agent.client)
  agents: Relation<EntityAgent[]>
}

补充说明 #

• @JoinColumn是可选的，但显式指定外键列名可以避免TypeORM自动推断出错，尤其当数据库字段名和实体属性名不一致时
• 确保两个实体的关联装饰器互相指向对方的关联属性，这是TypeORM双向关联的核心要求

修改完成后重启应用，再执行你原来的Repository或DataSource Manager查询代码，关联数据就能正常加载了。

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