Sequelize关联报错：如何正确配置产品与材料、用户的关联？

问题场景与报错 #

现有products表，通过UUID数组字段materials存储关联的材料ID，关联Materials表时出现以下错误：

AssociationError [SequelizeAssociationError]: product.belongsToMany(material) requires through option, pass either a string or a model

用户原代码：

class Product extends Model {
  static associate(models) {
    Product.belongsToMany(models.material, {
      foreignKey: 'id',
      sourceKey: 'materials',
      constraints: false,
    });

    Product.belongsTo(models.user, {
      foreignKey: 'id',
      sourceKey: 'creator',
    });
  }
}
Product.init(
  {
    id: {
      type: DataTypes.UUID,
      defaultValue: DataTypes.UUIDV4,
      primaryKey: true,
    },
    name: {
      type: DataTypes.STRING,
      allowNull: false,
    },
    quantity: {
      type: DataTypes.DECIMAL,
      allowNull: false,
      defaultValue: 0.0,
    },
    materials: {
      type: DataTypes.ARRAY(DataTypes.UUID),
    },
    creator: {
      type: DataTypes.UUID,
    },
    updater: {
      type: DataTypes.UUID,
    },
  },
  {
    sequelize,
    modelName: 'product',
  }
);

错误原因 #

belongsToMany是Sequelize为传统多对多关系设计的关联方式，要求必须通过中间表（即through选项）关联两张表的主键，而你的设计是直接在products表用数组存储关联ID，不符合这种关联的数据库结构，因此触发报错。

同时，你配置的Product.belongsTo(models.user)存在参数错误：foreignKey应指向当前表的关联字段（creator），targetKey指向关联表的主键（id），原代码参数写反了。

解决方案 #

方案1：改用标准多对多关联（推荐） #

遵循关系型数据库设计规范，创建中间表product_materials存储产品与材料的关联关系：

1. 定义中间表模型

class ProductMaterial extends Model {}
ProductMaterial.init(
  {
    productId: {
      type: DataTypes.UUID,
      references: { model: 'product', key: 'id' },
      primaryKey: true,
    },
    materialId: {
      type: DataTypes.UUID,
      references: { model: 'material', key: 'id' },
      primaryKey: true,
    },
  },
  {
    sequelize,
    modelName: 'productMaterial',
    timestamps: false,
  }
);

2. 修改Product模型的关联配置

static associate(models) {
  // 产品与材料的多对多关联
  Product.belongsToMany(models.material, {
    through: models.productMaterial,
    foreignKey: 'productId', // 中间表中指向product的字段
    otherKey: 'materialId', // 中间表中指向material的字段
  });

  // 修正产品与用户的关联
  Product.belongsTo(models.user, {
    foreignKey: 'creator', // product表中的关联字段
    targetKey: 'id', // user表的主键
  });
}

方案2：保留数组存储，手动处理关联查询 #

如果要保留现有数组存储的设计，放弃使用belongsToMany，改为手动关联查询：

1. 查询时关联材料

const { Op } = require('sequelize');

// 查询单个产品及对应的材料
const product = await Product.findByPk(productId, {
  include: [
    {
      model: Material,
      where: { id: { [Op.in]: Sequelize.col('product.materials') } },
      required: false, // 无关联材料时仍返回产品
    },
  ],
});

2. 或在模型中添加自定义方法封装查询

class Product extends Model {
  static async getWithMaterials(productId) {
    const product = await this.findByPk(productId);
    if (product?.materials?.length) {
      product.materialsDetail = await Material.findAll({
        where: { id: { [Op.in]: product.materials } },
      });
    }
    return product;
  }
}

// 使用示例
const productWithMaterials = await Product.getWithMaterials('某个产品UUID');

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