NestJs使用MikroORM实现多租户时迁移报错TypeError

问题场景 #

在NestJS服务中使用Mikro-ORM实现多租户功能，定义了两个抽象实体：

• BaseEntity：仅包含主键id的抽象实体
• MultiTenantEntity：关联TenantEntity的抽象实体
• UserEntity：继承MultiTenantEntity的业务实体

执行命令npx mikro-orm migration:create时，报错：

TypeError: Class extends value undefined is not a constructor or null
  at Object.<anonymous> (C:\Projects\Development\<project>\libs\database-entities\src\lib\user\user.entity.ts:8:33)
  at Module._compile (node:internal/modules/cjs/loader:1218:14)
  at Module.m._compile (C:\Projects\Development\<project>\node_modules\ts-node\src\index.ts:1618:23)
  at Module._extensions..js (node:internal/modules/cjs/loader:1272:10)
  at Object.require.extensions.<computed> [as .ts] (C:\Projects\Development\<project>\node_modules\ts-node\src\index.ts:1621:12)
  at Module.load (node:internal/modules/cjs/loader:1081:32)
  at Function.Module._load (node:internal/modules/cjs/loader:922:12)
  at Module.require (node:internal/modules/cjs/loader:1105:19)
  at require (node:internal/modules/cjs/helpers:103:18)
  at Object.<anonymous> (C:\Projects\Development\<project>\libs\database-entities\src\lib\database-entities.ts:3:1)

错误指向UserEntity继承MultiTenantEntity的代码行。

原错误实体代码 #

BaseEntity #

@Entity({ abstract: true })
export abstract class BaseEntity {
  @PrimaryKey()
  id: number;
}

MultiTenantEntity #

@Entity({ abstract: true })
export abstract class MultiTenantEntity {
  @ManyToOne(() => TenantEntity)
  tenant: Ref<TenantEntity, 'id'>;

  constructor(tenant: TenantEntity) {
    super();
    this.tenant = ref(tenant);
  }
}

UserEntity #

@Entity({ tableName: 'users' })
export class UserEntity extends MultiTenantEntity {
  @Property()
  email: string;

  @Property()
  firstName: string;

  @Property()
  lastName: string;

  @ManyToOne(() => RoleEntity)
  role: Ref<RoleEntity, 'id'>;

  constructor(role: RoleEntity, tenant: TenantEntity) {
    super(tenant);
    this.role = ref(role);
  }
}

解决方案 #

1. 修复MultiTenantEntity的继承关系 #

MultiTenantEntity的构造函数调用了super()，但原代码未继承任何父类，这会直接导致类定义失效，让UserEntity继承时拿到undefined。需要让MultiTenantEntity正确继承BaseEntity：

修改后的MultiTenantEntity代码：

@Entity({ abstract: true })
export abstract class MultiTenantEntity extends BaseEntity {
  @ManyToOne(() => TenantEntity)
  tenant: Ref<TenantEntity, 'id'>;

  constructor(tenant: TenantEntity) {
    super(); // 现在调用BaseEntity的构造函数，符合语法要求
    this.tenant = ref(tenant);
  }
}

2. 检查导入路径与循环引用 #

• 确认UserEntity中MultiTenantEntity的导入路径正确，避免拼写错误或相对路径错误
• 检查实体间的循环引用：如果TenantEntity或RoleEntity反向引用了UserEntity，必须使用延迟导入（即@ManyToOne中使用箭头函数() => TenantEntity而非直接导入类），避免模块加载顺序问题导致实体未被正确初始化

3. 验证依赖实体存在性 #

确认TenantEntity和RoleEntity已正确定义且能被正常导入，不存在文件缺失或语法错误，否则会导致依赖它们的MultiTenantEntity、UserEntity无法正常加载

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