Sequelize关联配置报错：EmployeeModel has not been defined

我需要在Sequelize中实现DepartmentModel包含一个员工数组，每个EmployeeModel关联其所属的单个部门，编写了如下代码：

DepartmentModel 代码 #

@Table
export class DepartmentModel extends Model{

    @AutoIncrement
    @Unique
    @PrimaryKey
    @Column
    id: number;

    @Column
    title: string;

    @Column
    headId: number;

    @Column
    @CreatedAt
    creationDate: Date;

    @Column
    departmentInfo: string;

    @HasMany(() => EmployeeModel, "id")
    employees: EmployeeModel[];
}

EmployeeModel 代码 #

@Table
export class EmployeeModel extends Model{

    @AutoIncrement
    @Unique
    @PrimaryKey
    @Column
    id: number;

    @Column
    firstName: string

    @Column
    surname: string

    @Column
    post: string

    @ForeignKey(() => DepartmentModel)
    @BelongsTo(() => DepartmentModel,'id')
    departmentId: DepartmentModel;
}

运行时出现错误：

EmployeeModel has not been defined

代码写法与官方文档几乎一致，请问问题出在哪里？

问题原因及修正方案 #

1. 模型定义顺序与引用时机问题

当DepartmentModel中通过@HasMany(() => EmployeeModel)引用员工模型时，若两个模型在同一文件中且EmployeeModel定义在DepartmentModel之后，TypeScript编译阶段可能会因EmployeeModel未完成定义就被引用而报错。

解决：

• 若在同一文件，将EmployeeModel的定义放在DepartmentModel之前；
• 若分文件存放，确保初始化Sequelize时通过sequelize.addModels([DepartmentModel, EmployeeModel])或完整导入所有模型文件，保证两个模型都被加载。

2. @BelongsTo装饰器参数与字段类型错误

• departmentId是存储外键的字段，类型应为number而非DepartmentModel，关联的模型实例需单独定义（如department）；
• @BelongsTo的第二个参数是外键字段名而非关联模型的主键名，此处可省略让Sequelize自动推断；
• 遗漏了@Column装饰器，导致Sequelize不会将departmentId作为数据库字段生成。

3. @HasMany的外键参数错误

@HasMany的第二个参数应是EmployeeModel中指向DepartmentModel的外键名departmentId，而非DepartmentModel的主键id。

完整修正后的代码示例 #

EmployeeModel（若同文件，需放在DepartmentModel之前）

@Table
export class EmployeeModel extends Model{

    @AutoIncrement
    @Unique
    @PrimaryKey
    @Column
    id: number;

    @Column
    firstName: string

    @Column
    surname: string

    @Column
    post: string

    @ForeignKey(() => DepartmentModel)
    @Column
    departmentId: number;

    @BelongsTo(() => DepartmentModel)
    department: DepartmentModel;
}

DepartmentModel

@Table
export class DepartmentModel extends Model{

    @AutoIncrement
    @Unique
    @PrimaryKey
    @Column
    id: number;

    @Column
    title: string;

    @Column
    headId: number;

    @Column
    @CreatedAt
    creationDate: Date;

    @Column
    departmentInfo: string;

    @HasMany(() => EmployeeModel, "departmentId")
    employees: EmployeeModel[];
}

额外注意事项 #

• 检查tsconfig.json，确保experimentalDecorators和emitDecoratorMetadata已设为true，启用装饰器功能；
• 分文件时避免循环导入，可通过在模型中使用箭头函数延迟引用或统一在Sequelize初始化时加载所有模型。

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