Sequelize关联报错：belongsTo传入非Model子类的原因排查

错误原因 #

你遇到的sub_category.belongsTo called with something that's not a subclass of Sequelize.Model错误，核心问题有两个：

1. 导入对象错误：你在两个模型中导入的category和subcat，是对方模块导出的包含初始化函数（initCategoryModel/initSubcatModel）的对象，并非真正的Sequelize Model实例，而belongsTo/hasMany方法必须接收Sequelize Model子类作为参数。
2. 循环依赖+异步初始化冲突：两个模型模块互相导入，加上初始化是异步操作，导致关联执行时，对方的Model实例还未创建完成，传递的参数不符合要求。

解决方案 #

调整模型初始化逻辑，确保在建立关联时，双方都已经生成了有效的Sequelize Model实例，同时避免循环导入的问题。

修改后的Category模型代码 #

const { DataTypes } = require("sequelize");
const { getConnection } = require("../helper/databaseConnection");

const categoryModel = {
  category_id: {
    primaryKey: true,
    type: DataTypes.UUID,
    defaultValue: DataTypes.UUIDV4,
  },
  category_name: {
    type: DataTypes.STRING,
    allowNull: false,
  },
};

let category = null;
const initCategoryModel = async () => {
  try {
    if (category) return category;
    const sequelize = await getConnection();
    category = sequelize.define("category", categoryModel, {
      freezeTableName: true,
    });

    // 动态导入并初始化子分类模型，获取实例后建立关联
    const { initSubcatModel } = require("./subCategory");
    const subcat = await initSubcatModel();
    category.hasMany(subcat, {
      foreignKey: "category_id",
      onDelete: "CASCADE",
    });

    await category.sync({ alter: true });
    return category;
  } catch (err) {
    console.log("category", err);
  }
};

module.exports = { initCategoryModel };

修改后的SubCategory模型代码 #

const { DataTypes } = require("sequelize");
const { getConnection } = require("../helper/databaseConnection");

const subcatModel = {
  subcat_id: {
    primaryKey: true,
    type: DataTypes.UUID,
    defaultValue: DataTypes.UUIDV4,
  },
  subcat_name: {
    type: DataTypes.STRING,
    allowNull: false,
  },
  // 显式定义外键字段，确保数据库表结构正确
  category_id: {
    type: DataTypes.UUID,
    allowNull: false,
    references: {
      model: "category",
      key: "category_id"
    }
  }
};

let subcat = null;
const initSubcatModel = async () => {
  try {
    if (subcat) return subcat;
    const sequelize = await getConnection();
    subcat = sequelize.define("sub_category", subcatModel, {
      freezeTableName: true,
    });

    // 动态导入并初始化分类模型，获取实例后建立关联
    const { initCategoryModel } = require("./category");
    const category = await initCategoryModel();
    subcat.belongsTo(category, {
      foreignKey: "category_id",
      onDelete: "CASCADE",
    });

    await subcat.sync({ alter: true });
    return subcat;
  } catch (err) {
    console.log("sub category", err);
  }
};

module.exports = { initSubcatModel };

额外说明 #

• 在子分类模型中显式添加category_id外键字段，确保数据库表能生成正确的关联结构。
• 将对方模型的导入逻辑移到初始化函数内部，避免循环依赖导致的模块加载异常。
• 确保建立关联前，对方的Model已经完成异步初始化，传递的是有效的Sequelize Model实例。

内容的提问来源于stack exchange，提问作者sumanth.js