Sequelize TypeScript一对多关联执行sync({alter:true})重复新增外键

问题核心原因 #

重复添加外键的本质是模型字段的代码命名与数据库实际字段映射不一致，加上关联配置的细微差异，导致sequelize执行sync({alter: true})时无法识别已存在的外键，每次启动都重新创建。

解决方案 #

1. 统一外键字段的映射与关联配置 #

确保User模型中roleId的数据库字段映射、@ForeignKey、@BelongsTo配置完全匹配，同时Role模型的@HasMany配置也要对应一致。

修改后的User模型：

import {
    Table,
    Column,
    Model,
    DataType,
    PrimaryKey,
    AutoIncrement,
    ForeignKey,
    BelongsTo,
    HasMany,
} from 'sequelize-typescript';
import { Role } from './Roles';
import { UserGroupLink } from './UserGroupLink';
import { Validation } from './Validations';

@Table({
    tableName: 'Users',
    timestamps: false,
})
export class User extends Model {
    @PrimaryKey
    @AutoIncrement
    @Column({
        type: DataType.INTEGER.UNSIGNED,
        field: 'ID',
    })
    id!: number;

    @Column({
        type: DataType.STRING,
        allowNull: false,
        field: 'Name',
    })
    email!: string;

    // 统一外键的字段映射与约束规则
    @ForeignKey(() => Role)
    @Column({
        type: DataType.INTEGER.UNSIGNED,
        allowNull: false,
        field: 'RoleID', // 严格匹配数据库实际字段名
        onUpdate: 'CASCADE',
        onDelete: 'CASCADE',
    })
    roleId!: number;

    // BelongsTo关联直接绑定字段名，无需重复定义约束
    @BelongsTo(() => Role, 'roleId')
    role!: Role;

    @HasMany(() => UserGroupLink, {
        foreignKey: 'userId',
        sourceKey: 'id',
        as: 'userGroupLinks',
    })
    userGroupLinks!: UserGroupLink[];

    @HasMany(() => Validation, {
        foreignKey: 'userId',
        sourceKey: 'id',
        as: 'validations',
    })
    validations!: Validation[];
}

修改后的Role模型：

import { Table, Column, Model, DataType, PrimaryKey, AutoIncrement, HasMany } from 'sequelize-typescript';
import { User } from './Users';

@Table({
    tableName: 'Roles',
    timestamps: false,
})
export class Role extends Model {
    @PrimaryKey
    @AutoIncrement
    @Column({
        type: DataType.INTEGER.UNSIGNED,
        field: 'ID',
    })
    id!: number;

    @Column({
        type: DataType.STRING,
        allowNull: false,
        field: 'Name',
    })
    name!: string;

    @Column({
        type: DataType.TEXT,
        field: 'Description',
    })
    description!: string | null;

    // HasMany关联直接指定外键的代码字段名
    @HasMany(() => User, 'roleId')
    users!: User[];
}

2. 清理已重复创建的外键 #

手动登录数据库，删除Users表中所有多余的指向Roles的外键（仅保留一个有效外键即可），再重启服务执行sync操作。

3. 关键注意事项 #

• 约束规则（如onUpdate/onDelete）只需要在@Column的配置中声明一次，避免在@BelongsTo选项中重复定义。
• 对于大小写敏感的数据库，必须确保模型中field属性与数据库实际字段名完全匹配。

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