TypeORM创建带OneToOne关联User时报MustBeEntityError如何解决

错误原因 #

你的报错来自两个核心配置问题：

1. 开启了cascade: true级联保存，TypeORM存储User实体时会尝试自动保存关联的profile字段，注册时profile未赋值为undefined，就会抛出MustBeEntityError
2. 手动重复定义了profileId外键列，还设置了不合理的默认值-1，和@JoinColumn自动生成的外键逻辑冲突，且@OneToOne默认关联为必填，所以接口会要求必须传profile参数

具体修改步骤 #

1. 修改User实体配置 #

删除手动定义的profileId列，关闭级联保存，设置关联允许为空：

@Entity("User")
export class User extends BaseEntity {
  @PrimaryGeneratedColumn()
  id: number;

  @Column("text")
  name: string;

  @Column("text")
  password: string;

  @Column("text")
  email: string;

  @OneToOne(() => Profile, { nullable: true })
  @JoinColumn() // TypeORM会自动生成profileId外键列，无需手动定义
  profile: Profile;

  // 若需要直接读取profileId的值，添加这个虚拟映射字段即可
  @Column({ nullable: true, insert: false, update: false })
  profileId: number;
}

Profile实体无需修改，原有配置可以正常使用。

2. 调整业务逻辑 #

注册接口逻辑

注册时不需要传入profile相关参数，直接保存用户基础信息即可，此时profileId自动为null，不会触发报错：

// 注册接口示例代码
async register(userData: {name: string, password: string, email: string}) {
  const user = User.create(userData);
  await user.save();
  return user;
}

后续关联Profile逻辑

用户完善资料时，先创建Profile实例存储，再关联到对应用户即可：

// 绑定用户资料接口示例代码
async saveUserProfile(userId: number, profileData: {gender?: string, occupation?: string}) {
  // 新建并保存Profile实体
  const profile = Profile.create(profileData);
  await profile.save();
  // 关联到对应用户
  const user = await User.findOneBy({ id: userId });
  user.profile = profile;
  await user.save();
  return user;
}

如果不想操作关联实体，也可以直接给user.profileId赋值为新创建的profile的id，效果完全一致。

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