Sequelize多对多关联查询出现未知列RoleRoleId错误排查

出现ER_BAD_FIELD_ERROR（未知列'RoleRoleId'）的核心原因是关联配置冲突，具体问题点如下：

1. Role模型中错误添加了无效关联：Role.hasMany(models.User); 这行代码会让Sequelize误以为Role和User是一对多关系，自动尝试生成名为RoleRoleId的外键列，但你的数据库中根本不存在这个列。
2. User模型中多余的关联声明：User.hasMany(models.User_Role); 属于冗余配置，因为belongsToMany已经通过中间表user_roles建立了User和Role的多对多关联，无需单独声明到中间表的hasMany关系。

修正后的代码 #

1. 修正 role.model.js 的关联逻辑 #

删除错误的hasMany关联：

'use strict';
const { Model } = require('sequelize');
module.exports = (sequelize, DataTypes) => {
  class Role extends Model {
    static associate(models) {
      Role.belongsToMany(models.User, {
        through: 'user_roles',
        foreignKey: 'role_id',
        otherKey: 'user_id',
        onDelete: 'CASCADE',
        onUpdate: 'CASCADE',
      });
      // 移除这行错误关联
      // Role.hasMany(models.User);
    }
  }
  Role.init(
    {
      role_id: {
        type: DataTypes.INTEGER,
        primaryKey: true,
        autoIncrement: true,
      },
      user_type: {
        type: DataTypes.ENUM('donor', 'receiver', 'courier', 'admin'),
        defaultValue: 'courier',
      },
    },
    {
      sequelize,
      modelName: 'Role',
    }
  );
  return Role;
};

2. 修正 user.model.js 的关联逻辑 #

移除多余的hasMany到中间表的关联：

'use strict';
const { Model } = require('sequelize');
module.exports = (sequelize, DataTypes) => {
  class User extends Model {
    static associate(models) {
      User.belongsToMany(models.Role, {
        through: 'user_roles',
        foreignKey: 'user_id',
        otherKey: 'role_id',
        onDelete: 'CASCADE',
        onUpdate: 'CASCADE',
      });
      // 移除这行冗余关联
      // User.hasMany(models.User_Role);

      User.hasMany(models.Address, {
        foreignKey: 'user_id',
        onDelete: 'CASCADE',
        onUpdate: 'CASCADE',
      });

      User.hasOne(models.Receiver, {
        foreignKey: 'user_id',
        onDelete: 'CASCADE',
        onUpdate: 'CASCADE',
      });
    }
  }
  User.init(
    {
      user_id: {
        type: DataTypes.INTEGER,
        primaryKey: true,
        autoIncrement: true,
      },
      email: DataTypes.STRING,
      password: DataTypes.STRING,
      bio: DataTypes.STRING,
      activity_status: DataTypes.BOOLEAN,
    },
    {
      sequelize,
      modelName: 'User',
    }
  );
  return User;
};

关键说明 #

• Sequelize的多对多关联仅需通过双方模型的belongsToMany声明即可，框架会自动处理中间表的关联查询逻辑，无需额外添加到中间表的hasMany或错误的一对多关联。
• 你的中间表迁移文件（6-create-user_role.js）配置是正确的，外键user_id和role_id已正确关联到对应表的主键，无需修改。

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