TypeORM多对一联复合主键报错：关联列profile_id未找到于Profile实体

核心原因 #

你遇到的错误是因为Profile使用复合主键，但在Score的@JoinColumn配置中没有完整指定所有主键字段，或者错误地使用了数据库列名而非实体属性名。TypeORM关联时，referencedColumnName需要对应实体类的属性名（比如你的profileId），而不是数据库表的列名（profile_id）。

正确的实体配置示例 #

1. Profile实体（复合主键配置） #

确保复合主键的实体属性与数据库列正确映射：

import { Entity, PrimaryColumn } from "typeorm";

@Entity({ name: "profiles" })
export class Profile {
  // 实体属性名是profileId，对应数据库列profile_id
  @PrimaryColumn({ name: "profile_id" })
  profileId: string;

  @PrimaryColumn()
  role: string;

  // 其他业务字段...
}

2. Score实体（多对一关联配置） #

必须在@JoinColumn中同时指定复合主键的所有字段，且referencedColumnName指向Profile的实体属性名：

import { Entity, Column, ManyToOne, JoinColumn, PrimaryGeneratedColumn } from "typeorm";
import { Profile } from "./Profile";

@Entity({ name: "scores" })
export class Score {
  @PrimaryGeneratedColumn()
  scoreId: number;

  @Column()
  value: number;

  // 多对一关联Profile
  @ManyToOne(() => Profile)
  @JoinColumn([
    { name: "profile_id", referencedColumnName: "profileId" }, // 外键列名 -> 实体属性名
    { name: "role", referencedColumnName: "role" } // 第二个主键字段
  ])
  profile: Profile;

  // 可选：如果需要单独操作外键字段，可添加以下映射
  @Column({ name: "profile_id" })
  profileId: string;

  @Column()
  role: string;
}

常见错误排查 #

• 遗漏复合主键字段：比如只配置了profile_id关联，漏掉了role字段，导致TypeORM无法识别完整的关联条件；
• referencedColumnName用错值：写成referencedColumnName: "profile_id"，但实体属性名是profileId，导致TypeORM找不到对应实体属性；
• 实体与数据库列映射错误：检查Profile实体中@PrimaryColumn的name参数是否正确对应数据库表列名。

验证步骤 #

1. 若开启TypeORM的synchronize配置，启动应用后检查数据库是否生成了关联两个主键列的外键约束；
2. 手动核对scores表的外键是否同时关联profiles表的profile_id和role列；
3. 重新编译TypeScript代码，确保没有隐性类型错误。

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