Sequelize belongsToMany报TypeError及自定义外键配置问题

你遇到的报错和自定义外键不生效问题，由3个核心问题导致：

1. 外键依赖报错的直接原因：中间表字段references.model配置写法错误，模型实例是挂载在sequelize.models对象下，不是直接挂载在sequelize实例上，你写的sequelize.user、sequelize.s_requirement实际取值为undefined，Sequelize解析外键依赖时拿不到合法的非空模型名，就会抛出Dependency name must be given as a not empty string错误。
2. 自定义外键不生效的原因：两个主表的belongsToMany关联没有显式指定foreignKey和otherKey，Sequelize会默认按照「模型名+主键名」的规则自动生成外键字段，不会自动匹配你自定义的usre_tutor_id、usre_requ_id字段。
3. 代码存在基础语法/结构错误：Requirement模型类名带多余的**符号，三个模型都漏了init方法调用、漏写模型返回语句，中间表的init逻辑写在导出函数外部，这些问题都会导致模型加载、关联注册异常。

1. User主表配置 #

在关联配置中显式指定双方在中间表对应的自定义外键，补全模型初始化和返回逻辑：

'use strict';
const { Model } = require('sequelize');
module.exports = (sequelize, DataTypes) => {
  class user extends Model {
    static associate(models) {
      this.belongsToMany(models.s_requirement, {
        through: models.s_user_requirement,
        foreignKey: 'usre_tutor_id', // 当前User表在中间表对应的外键字段
        otherKey: 'usre_requ_id' // 关联的Requirement表在中间表对应的外键字段
      })
    }
  }

  // 按业务实际补全User表字段，示例仅保留主键
  user.init({
    user_id: {
      type: DataTypes.UUID,
      primaryKey: true,
      defaultValue: DataTypes.UUIDV4
    }
  }, {
    sequelize,
    modelName: 'user',
    tableName: 'user'
  })

  return user;
}

2. Requirement主表配置 #

反向关联的外键配置需要和正向关联对应，注意foreignKey和otherKey顺序调换：

'use strict';
const { Model } = require('sequelize');
module.exports = (sequelize, DataTypes) => {
  // 移除类名多余的**符号
  class s_requirement extends Model {
    static associate(models) {
      this.belongsToMany(models.user, {
        through: models.s_user_requirement,
        foreignKey: 'usre_requ_id', // 当前Requirement表在中间表对应的外键字段
        otherKey: 'usre_tutor_id' // 关联的User表在中间表对应的外键字段
      })
    }
  }

  // 按业务实际补全Requirement表字段，示例仅保留主键
  s_requirement.init({
    requ_id: {
      type: DataTypes.UUID,
      primaryKey: true,
      defaultValue: DataTypes.UUIDV4
    }
  }, {
    sequelize,
    modelName: 's_requirement',
    tableName: 's_requirement'
  })

  return s_requirement;
}

3. s_user_requirement中间表配置 #

将init逻辑移到导出函数内部，不需要手动给外键字段加references配置，Sequelize会根据主表的关联规则自动生成外键约束：

'use strict';
const { Model } = require('sequelize');
module.exports = (sequelize, DataTypes) => {
  class s_user_requirement extends Model {}

  s_user_requirement.init({
    usre_id: {
      type: DataTypes.UUID,
      primaryKey: true,
      defaultValue: DataTypes.UUIDV4
    },
    usre_tutor_id: {
      type: DataTypes.UUID,
      allowNull: false
    },
    usre_requ_id: {
      type: DataTypes.UUID,
      allowNull: false
    }
  }, {
    sequelize,
    modelName: 's_user_requirement',
    tableName: 's_user_requirement'
    // 不需要自动生成createdAt、updatedAt时可开启下方配置
    // timestamps: false
  })

  return s_user_requirement;
}

• 确保模型加载顺序正确：先加载user、s_requirement两个主表，最后加载中间表，所有模型加载完成后再统一调用各模型的associate方法注册关联，否则会触发模型找不到的异常。
• 你当前自定义的外键字段前缀usre是user的拼写错误，如果不是业务特殊要求，建议修正为正确拼写，避免后续维护产生混淆。
• 如果坚持要在中间表字段内手动配置references，model属性需要传入字符串类型的模型名/表名，不能直接引用sequelize实例上不存在的属性，正确写法为model: 'user'、model: 's_requirement'，但这种配置方式不如在belongsToMany中统一指定外键稳妥，容易出现关联配置不一致的问题。

内容的提问来源于stack exchange，提问作者John Chris Cayetano