Sequelize预加载异常求助：muscular_groups与exercises关联失败

错误原因拆解 #

• "include.model.getTableName is not a function"：include配置中传入的不是合法的Sequelize模型实例，比如误传字符串、未初始化的模型对象
• "muscular_groups is not associated to exercises!"：两个模型间未正确建立关联，或查询时使用的关联名称与模型定义不匹配

分步解决步骤 #

1. 确保模型定义及关联配置正确 #

以下是规范的模型定义示例，根据你的实际表结构调整字段和关联关系：

muscular_group 模型

// models/muscular_group.js
module.exports = (sequelize, DataTypes) => {
  const MuscularGroup = sequelize.define('muscular_group', {
    id: {
      type: DataTypes.INTEGER,
      primaryKey: true,
      autoIncrement: true
    },
    name: DataTypes.STRING
    // 其他业务字段
  });

  MuscularGroup.associate = models => {
    // 根据实际关系选择hasMany/belongsToMany等，外键要和exercise模型对应
    MuscularGroup.hasMany(models.exercise, { foreignKey: 'muscular_group_id' });
  };

  return MuscularGroup;
};

exercise 模型

// models/exercise.js
module.exports = (sequelize, DataTypes) => {
  const Exercise = sequelize.define('exercise', {
    id: {
      type: DataTypes.INTEGER,
      primaryKey: true,
      autoIncrement: true
    },
    name: DataTypes.STRING,
    muscular_group_id: DataTypes.INTEGER // 与muscular_group模型的外键对应
    // 其他业务字段
  });

  Exercise.associate = models => {
    Exercise.belongsTo(models.muscular_group, { 
      foreignKey: 'muscular_group_id',
      as: 'muscular_group' // 定义别名，查询时需对应使用
    });
  };

  return Exercise;
};

2. 确保关联关系被正确初始化 #

在模型入口文件中，必须调用所有模型的associate方法，完成关联绑定：

// models/index.js
const fs = require('fs');
const path = require('path');
const Sequelize = require('sequelize');
const basename = path.basename(__filename);
const config = require('../config/config.json')[process.env.NODE_ENV || 'development'];
const db = {};

let sequelize = new Sequelize(config.database, config.username, config.password, config);

// 加载所有模型
fs.readdirSync(__dirname)
  .filter(file => file !== basename && file.slice(-3) === '.js')
  .forEach(file => {
    const model = require(path.join(__dirname, file))(sequelize, Sequelize.DataTypes);
    db[model.name] = model;
  });

// 执行所有模型的关联配置
Object.keys(db).forEach(modelName => {
  if (db[modelName].associate) {
    db[modelName].associate(db);
  }
});

db.sequelize = sequelize;
module.exports = db;

3. 修正查询逻辑 #

查询时必须传入正确的模型实例，且关联名称（含别名）要与模型定义一致：

const db = require('./models');

// 查询所有exercise并预加载关联的muscular_group完整数据
db.exercise.findAll({
  include: [
    {
      model: db.muscular_group,
      as: 'muscular_group' // 必须和exercise模型associate中定义的别名一致，未定义别名可省略
    }
  ]
})
.then(exercises => {
  // 返回的每个exercise对象会包含完整的muscular_group数据，而非仅ID
  console.log(JSON.stringify(exercises, null, 2));
})
.catch(err => console.error(err));

常见排查点 #

• 禁止在include中传入模型名称字符串（如model: 'muscular_group'），必须传入从db对象获取的模型实例
• 确认外键字段名称在模型和数据库表中完全一致
• 关联方向要匹配：belongsTo与hasMany/hasOne需成对定义
• 查询时的as别名必须与模型关联配置中的as完全一致

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