TypeORM：如何正确保存带有{nullable: false}的懒加载关联实体？

问题根源 #

TypeORM处理懒加载关联的保存逻辑时，没办法从Promise.resolve(Organization实例)里提取外键值，导致插入用户记录时oid字段是空的，触发了数据库的非空约束错误。

解决方案 #

方案1：调整关联属性类型，直接赋值实体实例 #

修改User实体中org的类型为Organization | Promise<Organization>，保存时直接给它赋值Organization实例（不用Promise包装）：

@Entity('users')
export class User extends IdentifiableEntity implements OrganizationalEntity {
  
  ...

  @ManyToOne(() => Organization, org => org.users, {
    nullable: false,
  })
  @JoinColumn({name: 'oid'})
  org: Promise<Organization> | Organization;

  ...

}

保存代码示例：

user.org = new Organization(oid); // 直接赋值实例，无需Promise.resolve
await userRepository.save(user);

方案2：显式定义外键字段（更推荐） #

在User实体里直接声明oid字段，保存时直接给外键赋值，不需要创建空的Organization实例：

@Entity('users')
export class User extends IdentifiableEntity implements OrganizationalEntity {
  
  ...

  // 显式声明外键字段
  @Column({ name: 'oid', nullable: false })
  oid: number;

  @ManyToOne(() => Organization, org => org.users, {
    nullable: false,
  })
  @JoinColumn({name: 'oid'})
  org: Promise<Organization>;

  ...

}

保存代码示例：

user.oid = oid; // 直接设置外键值
await userRepository.save(user);

关于懒加载的疑问 #

把org的类型设为Promise<Organization> | Organization不会破坏懒加载功能：

• 当你没主动加载关联（比如没用到relations或leftJoinAndSelect），第一次访问user.org时，TypeORM会返回Promise，保持懒加载的特性；
• 当你主动加载关联后，user.org会直接返回Organization实例，这个联合类型只是准确反映了属性在不同场景下的实际值类型。

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