Sequelize 6多对多关联模型循环导入未定义问题求助

你遇到的这个错误完全是循环导入导致的——当product.model.js导入category.model.js时，category.model.js又反过来导入product.model.js，此时其中一个模型还没完成定义，所以拿到的是undefined，自然无法调用belongsToMany。

要保留单文件单模型的结构，最优雅也最符合Sequelize官方推荐的方式是使用模型的associate方法延迟关联定义，具体步骤如下：

步骤1：给每个模型添加associate方法 #

修改你的模型文件，把关联逻辑放到associate方法里，这个方法会接收所有已加载的模型作为参数，避免直接导入带来的循环问题：

product.model.js #

const Product = sequelize.define('Product', {}, { tableName : 'products', underscored: true, });

// 定义关联方法，通过传入的models对象获取其他模型
Product.associate = (models) => {
  Product.belongsToMany(models.Category, {
    through: models.CategoryProduct,
    foreignKey: 'product_id',
    otherKey: 'category_id'
  });
};

export default Product;

category.model.js #

const Category = sequelize.define('Category', {}, { tableName : 'categories', underscored: true, });

Category.associate = (models) => {
  Category.belongsToMany(models.Product, {
    through: models.CategoryProduct,
    foreignKey: 'category_id'
  });
};

export default Category;

category_product.model.js #

中间表模型不需要修改（除非你需要给它添加额外字段或关联）：

const CategoryProduct = sequelize.define('CategoryProduct', {}, { tableName : 'category_products', underscored: true, });
export default CategoryProduct;

步骤2：在入口文件统一初始化关联 #

创建一个数据库入口文件（比如db/index.js），先加载所有模型，再遍历调用每个模型的associate方法，确保所有模型都已完成定义后再建立关联：

// 导入你的Sequelize实例和所有模型
import sequelize from './sequelize-instance'; // 假设这是你的Sequelize连接实例
import Product from '../models/product.model';
import Category from '../models/category.model';
import CategoryProduct from '../models/category_product.model';

// 把所有模型整理成一个对象
const models = {
  Product,
  Category,
  CategoryProduct
};

// 遍历执行所有模型的关联方法
Object.values(models).forEach(model => {
  if (typeof model.associate === 'function') {
    model.associate(models);
  }
});

// 导出实例和模型供其他地方使用
export { sequelize, models };

可选方案：直接使用模型名称字符串 #

如果你觉得添加associate方法有点繁琐，也可以在关联时直接传入模型的名称（字符串形式），Sequelize会自动从已注册的模型中查找对应的实例，这样就不需要导入其他模型了：

product.model.js #

// 无需导入Category和CategoryProduct，直接用名称字符串
const Product = sequelize.define('Product', {}, { tableName : 'products', underscored: true, });

Product.belongsToMany('Category', {
  through: 'CategoryProduct',
  foreignKey: 'product_id',
  otherKey: 'category_id'
});

export default Product;

category.model.js #

const Category = sequelize.define('Category', {}, { tableName : 'categories', underscored: true, });

Category.belongsToMany('Product', {
  through: 'CategoryProduct',
  foreignKey: 'category_id'
});

export default Category;

这种方式更简洁，但要注意模型名称必须和define时的第一个参数完全一致，否则会找不到模型导致报错。

两种方案都能完美解决循环导入的问题，同时保留你想要的单文件单模型结构，推荐第一种associate的方式，因为它的可读性更强，也更易于维护。

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