使用TypeORM定义实体时出现初始化前访问User错误，如何解决？

错误信息 #

ReferenceError: Cannot access 'User' before initialization
    at file:///C:/Users/Yu/Desktop/Projects/keytest/keytest-backend/models/CompanyUser.ts:23:9

注释CompanyUser实体中user字段的ManyToOne装饰器即可消除错误。

相关代码 #

User实体 #

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

  @Column()
  firstName: string;

  @Column()
  lastName: string;

  @Column()
  email: string;

  @CreateDateColumn()
  createdAt: Date;

  @OneToMany(() => CompanyUser, companyUser => companyUser.user, { onDelete: 'CASCADE' })
  companyUsers: CompanyUser[];
}

Company实体 #

export class Company extends BaseEntity {
  @PrimaryGeneratedColumn()
  id: number;

  @CreateDateColumn()
  createdAt: Date;

  @Column()
  name: string;

  @OneToMany(() => CompanyUser, companyUser => companyUser.company)
  companyUsers: CompanyUser[];
}

CompanyUser实体 #

export class CompanyUser extends BaseEntity {
  @PrimaryGeneratedColumn()
  id: number;
  
  @Column({ default: false })
  isVerified: boolean;

  @Column({ default: false })
  isAdmin: boolean;

  @Column({ default: false })
  isDisabled: boolean;
  
  @CreateDateColumn()
  createdAt: Date;
  
  @ManyToOne(() => User, user => user.companyUsers)
  user: User;

  @ManyToOne(() => Company, company => company.companyUsers)
  company: Company;
}

数据源配置 #

const AppDataSource = new DataSource({
    type: "postgres",
    host: process.env.BACKEND_URL,
    port: process.env.DB_PORT as unknown as number,
    username: process.env.DB_USERNAME,
    password: process.env.DB_PASSWORD,
    database: process.env.DB_NAME,
    entities: [User, Company, CompanyUser],
    synchronize: true,
    logging: true,
  });

错误原因 #

这是循环引用导致的运行时初始化顺序问题：

• 三个实体互相建立关联，形成循环依赖：User引用CompanyUser，CompanyUser引用User和Company，Company引用CompanyUser。
• TypeORM的装饰器在运行时执行，当加载CompanyUser模块时，User类因循环导入还未完成初始化，此时@ManyToOne装饰器直接引用User类就会触发"Cannot access before initialization"错误。
• 额外问题：Company实体缺失@Entity()装饰器，TypeORM无法识别该实体，会导致后续关联异常。

修复方案 #

方法一：使用字符串实体名替代直接类引用（最简便） #

修改CompanyUser实体的@ManyToOne装饰器，将第一个参数改为实体类的字符串名称，TypeORM会自动通过实体名匹配对应类，避免运行时引用问题：

export class CompanyUser extends BaseEntity {
  // ... 其他字段
  
  @ManyToOne('User', user => user.companyUsers)
  user: User;

  @ManyToOne('Company', company => company.companyUsers)
  company: Company;
}

同时给Company实体补充@Entity()装饰器：

@Entity()
export class Company extends BaseEntity {
  // ... 原有字段
}

方法二：使用动态导入实现懒加载（适合复杂场景） #

通过异步动态导入确保实体类已初始化后再引用：

export class CompanyUser extends BaseEntity {
  // ... 其他字段
  
  @ManyToOne(async () => (await import('./User')).User, user => user.companyUsers)
  user: User;

  @ManyToOne(async () => (await import('./Company')).Company, company => company.companyUsers)
  company: Company;
}

内容的提问来源于stack exchange，提问作者U. Watt