Node.js中Sequelize关联MySQL多对多出现冗余列问题

问题原因 #

使用belongsToMany建立多对多关联时，若未明确指定中间表的外键字段，Sequelize会自动基于模型名称生成默认外键（如SiteSiteId、CustomerCustomerId），而你已经手动在中间表定义了siteId和customerId，导致重复生成冗余字段。

解决步骤 #

1. 修正关联配置（核心操作） #

在index.js的关联代码中，为belongsToMany添加foreignKey和otherKey选项，明确指定中间表中已定义的外键字段：

const db = {};

db.DataTypes = DataTypes;
db.sequelize = sequelize;

db.Site = require("./Site")(db);
db.Customer = require("./Customers")(db);
db.SiteCustomer = require("./SiteCustomer")(db);

// 明确指定中间表外键，避免自动生成冗余列
db.Site.belongsToMany(db.Customer, {
  through: db.SiteCustomer,
  foreignKey: 'siteId',   // 中间表中指向Site的字段
  otherKey: 'customerId' // 中间表中指向Customer的字段
});

db.Customer.belongsToMany(db.Site, {
  through: db.SiteCustomer,
  foreignKey: 'customerId', // 中间表中指向Customer的字段
  otherKey: 'siteId'        // 中间表中指向Site的字段
});

2. 修正模型定义的参数格式（优化配置） #

你的部分模型定义中，sequelize.define的配置项被拆分成了多个独立对象，这会导致后续配置覆盖前面的设置（比如Site模型中tableName会覆盖timestamps: false），需要合并为单个配置对象：

Site.js 修正后：

module.exports = function ({ sequelize, DataTypes }) {
  const Site = sequelize.define(
    "Site",
    {
      siteId: {
        type: DataTypes.INTEGER,
        autoIncrement: true,
        allowNull: false,
        validate: { notEmpty: true },
        primaryKey: true,
      },
      siteName: {
        type: DataTypes.STRING(20),
        allowNull: false,
        validate: { notEmpty: true },
      },
    },
    {
      timestamps: false,
      tableName: "sites" // 合并所有配置到一个对象中
    }
  );
  return Site;
};

Customer.js 修正后：

module.exports = function ({ sequelize, DataTypes }) {
  const Customer = sequelize.define(
    "Customer",
    {
      customerId: {
        type: DataTypes.INTEGER,
        autoIncrement: true,
        allowNull: false,
        validate: { notEmpty: true },
        primaryKey: true,
      },
      customerName: {
        type: DataTypes.STRING(50),
        allowNull: false,
        validate: { notEmpty: true },
      },
    },
    {
      timestamps: false,
      tableName: "customers"
    }
  );
  return Customer;
};

SiteCustomer.js 修正后：

module.exports = ({ sequelize, DataTypes }) => {
  const SiteCustomer = sequelize.define(
    "site_customer",
    {
      scId: {
        type: DataTypes.INTEGER,
        primaryKey: true,
        autoIncrement: true,
        allowNull: false,
        validate: { notEmpty: true },
      },
      siteId: {
        type: DataTypes.INTEGER,
        references: { model: "sites", key: "siteId" },
        onDelete: "cascade",
        onUpdate: "cascade",
      },
      customerId: {
        type: DataTypes.INTEGER,
        references: { model: "customers", key: "customerId" },
        onDelete: "cascade",
        onUpdate: "cascade",
      },
    },
    {
      timestamps: false,
      tableName: "site_customer",
      indexes: [{ unique: true, fields: ["siteId", "customerId"] }]
    }
  );
  return SiteCustomer;
};

3. 重置数据库表（清理冗余列） #

如果之前已经生成了冗余列，需要删除现有表后重新同步，或者在开发环境使用alter: true让Sequelize自动修正表结构（生产环境建议手动执行迁移）：

// 启动代码中添加同步逻辑
db.sequelize.sync({ alter: true })
  .then(() => console.log("数据库同步完成"))
  .catch(err => console.error("同步失败:", err));

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