使用Sequelize配置表关联时MySQL外键重复创建问题求助

问题现象 #

使用Node.js开发服务端时，配置Sequelize表关联后，MySQL的Blogs表会重复生成外键，且每次重启服务器，外键名称都会自动变化（比如blogs_ibfk_4、blogs_ibfk_5）。

我的代码 #

启动脚本代码 #

const sequelize = require("./dbConnect");
const Admin = require("./model/adminModel");
const Banner = require("./model/bannerModel");
const Blogs = require("./model/blogsModel");
const BlogType = require("./model/blogtypeModel");
const md5 = require("md5");
(async function () {
  // 表关联配置
  BlogType.hasMany(Blogs, {
    foreignKey: "categoryId",
    targetKey: "id",
  });
  Blogs.belongsTo(BlogType, {
    foreignKey: "categoryId",
    targetKey: "id",
    as: "category",
  });

  // 同步表结构
  await sequelize.sync({
    alter: true,
  });
  const adminNumber = await Admin.count();
  if (!adminNumber) {
    await Admin.create({
      name: "MY",
      loginId: "root",
      loginPwd: md5("123456"),
    });
    console.log("Successful...");
  }
  
  const bannerNumber = await Banner.count();
  if (!bannerNumber) {
    await Banner.bulkCreate([
      {
        midImg: "/static/images/bg1_mid.jpg",
        bigImg: "/static/images/bg1_big.jpg",
        title: "Hello",
        description: "nothing",
      },
    ]);
    console.log("OK1...");
  }
  console.log("Over...");
})();

出问题的关联配置代码 #

BlogType.hasMany(Blogs, {
  foreignKey: "categoryId",
  targetKey: "id",
});
Blogs.belongsTo(BlogType, {
  foreignKey: "categoryId",
  targetKey: "id",
  as: "category",
});

问题原因 #

1. 关联配置重复执行：每次启动服务器都会执行启动脚本里的关联配置代码，加上sequelize.sync({alter: true})会自动修改表结构，重复的关联定义会导致Sequelize多次创建外键。
2. 未固定外键名称：没有显式指定外键约束名称，Sequelize会自动生成带递增编号的名称，每次重启都会生成新的。

解决方案 #

1. 将关联配置移至模型文件（避免重复执行） #

把关联逻辑放在各自的模型文件中，模型加载时只会执行一次，不会每次启动都重复定义。

修改BlogType模型

const { Model, DataTypes } = require('sequelize');
const sequelize = require('../dbConnect');
const Blogs = require('./blogsModel');

class BlogType extends Model {}

BlogType.init({
  id: {
    type: DataTypes.INTEGER,
    primaryKey: true,
    autoIncrement: true
  },
  // 其他字段根据实际需求定义
}, {
  sequelize,
  modelName: 'BlogType'
});

// 在模型中定义一对多关联，固定外键名称
BlogType.hasMany(Blogs, {
  foreignKey: 'categoryId',
  targetKey: 'id',
  constraintName: 'fk_blogs_category' // 固定外键约束名称
});

module.exports = BlogType;

修改Blogs模型

const { Model, DataTypes } = require('sequelize');
const sequelize = require('../dbConnect');
const BlogType = require('./blogtypeModel');

class Blogs extends Model {}

Blogs.init({
  id: {
    type: DataTypes.INTEGER,
    primaryKey: true,
    autoIncrement: true
  },
  categoryId: {
    type: DataTypes.INTEGER,
    // 提前声明外键关联
    references: {
      model: BlogType,
      key: 'id'
    }
  },
  // 其他字段根据实际需求定义
}, {
  sequelize,
  modelName: 'Blogs'
});

// 在模型中定义多对一关联，和hasMany使用相同的约束名称
Blogs.belongsTo(BlogType, {
  foreignKey: 'categoryId',
  targetKey: 'id',
  as: 'category',
  constraintName: 'fk_blogs_category'
});

module.exports = Blogs;

2. 修改启动脚本，移除关联配置 #

启动脚本中不再重复定义关联，只负责初始化数据和同步表结构：

const sequelize = require("./dbConnect");
const Admin = require("./model/adminModel");
const Banner = require("./model/bannerModel");
// 只需加载模型，关联已在模型中定义
const Blogs = require("./model/blogsModel");
const BlogType = require("./model/blogtypeModel");
const md5 = require("md5");

(async function () {
  // 同步表结构
  await sequelize.sync({
    alter: true,
  });
  
  // 初始化管理员数据
  const adminNumber = await Admin.count();
  if (!adminNumber) {
    await Admin.create({
      name: "MY",
      loginId: "root",
      loginPwd: md5("123456"),
    });
    console.log("Successful...");
  }
  
  // 初始化Banner数据
  const bannerNumber = await Banner.count();
  if (!bannerNumber) {
    await Banner.bulkCreate([
      {
        midImg: "/static/images/bg1_mid.jpg",
        bigImg: "/static/images/bg1_big.jpg",
        title: "Hello",
        description: "nothing",
      },
    ]);
    console.log("OK1...");
  }
  console.log("Over...");
})();

3. 清理现有重复外键 #

手动登录MySQL，删除Blogs表中多余的外键：

ALTER TABLE Blogs DROP FOREIGN KEY blogs_ibfk_4;
ALTER TABLE Blogs DROP FOREIGN KEY blogs_ibfk_5;

（替换成你实际存在的外键名称）

完成以上步骤后，重启服务器，Sequelize只会创建一个固定名称的外键，不会再重复生成。

内容的提问来源于stack exchange，提问作者I like front-end development