TypeORM实体循环引用报错：Cannot access 'User' before initialization

问题原因 #

你的Photo和User实体互相导入，形成了循环依赖。在ES模块加载机制中，两个模块互相引用时，会出现其中一个模块尚未完成初始化就被另一个模块访问的情况，从而触发该错误。

解决方案 #

方案1：使用动态延迟引用（推荐，保留类型检查） #

修改实体中的关系装饰器，将顶层直接导入改为在箭头函数内动态引用实体，避免循环导入导致的初始化冲突：

photo.ts 修改后：

import { Entity, PrimaryGeneratedColumn, Column, ManyToOne } from "typeorm"

@Entity()
export class Photo {
    @PrimaryGeneratedColumn()
    id: number

    @Column()
    url: string

    // 动态导入User实体，同时通过类型导入保留类型提示
    @ManyToOne(() => require("./User").User, (user) => user.photos)
    user: import("./User").User
}

user.ts 修改后：

import { Entity, PrimaryGeneratedColumn, Column, OneToMany } from "typeorm"

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

    @Column()
    name: string

    // 动态导入Photo实体，保留类型提示
    @OneToMany(() => require("./Photo").Photo, (photo) => photo.user)
    photos: import("./Photo").Photo[]
}

方案2：调整TypeScript编译配置 #

如果不想修改实体代码，可通过调整tsconfig.json的模块配置来兼容循环引用：
将module设置为CommonJS（CommonJS对循环引用的处理逻辑更宽松），同时确保moduleResolution为node：

{
  "compilerOptions": {
    "module": "CommonJS",
    "moduleResolution": "node",
    // 其他原有配置...
  }
}

方案3：使用字符串实体名称（临时方案，丢失类型检查） #

TypeORM支持直接用字符串指定实体名称，但会失去TypeScript的类型提示，仅适合临时调试：

photo.ts 修改：

@ManyToOne("User", (user) => user.photos)
user: User

user.ts 修改：

@OneToMany("Photo", (photo) => photo.user)
photos: Photo[]

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