如何在Sequelize.js中从关联模型加载属性？附用户与管理员模型代码

刚好我对Sequelize的关联加载很熟悉，结合你给出的User和Manager模型，我来一步步教你怎么实现关联属性的加载：

第一步：补全并明确你的模型定义 #

首先先把你给出的Manager模型补全（假设管理员有ManagerName属性，你可以根据实际业务调整）：

// User 模型
const UserMaster = sequelize.define('User', {
  UserId: { 
    type: DataTypes.BIGINT, 
    allowNull: false, 
    primaryKey: true, 
    autoIncrement: true 
  },
  RelationshipId: { 
    type: DataTypes.STRING, 
    allowNull: true 
  },
  UserName: { 
    type: DataTypes.STRING, 
    allowNull: true 
  }
})

// 补全后的 Manager 模型
const Manager = sequelize.define('Manager', {
  ManagerId: { 
    type: DataTypes.BIGINT, 
    allowNull: false, 
    primaryKey: true, 
    autoIncrement: true 
  },
  RelationshipId: { 
    type: DataTypes.STRING, 
    allowNull: true 
  },
  ManagerName: {
    type: DataTypes.STRING,
    allowNull: true
  }
})

第二步：定义模型间的关联关系 #

因为两个模型都通过RelationshipId字段关联，我们需要先明确关联类型（这里假设是一对一关联，如果是一对多你可以调整关联方法）：

// 正向关联：一个 User 对应一个 Manager
UserMaster.hasOne(Manager, {
  foreignKey: 'RelationshipId', // 关联模型（Manager）中的关联字段
  sourceKey: 'RelationshipId', // 当前模型（User）中的关联字段
  as: 'manager' // 关联别名，后续加载时用这个名称引用
})

// 反向关联：一个 Manager 对应一个 User
Manager.belongsTo(UserMaster, {
  foreignKey: 'RelationshipId',
  targetKey: 'RelationshipId',
  as: 'user'
})

注意：as的别名很重要，后续加载关联数据时必须和这个别名保持一致。

第三步：加载关联模型的属性 #

Sequelize提供了两种常见的加载方式，你可以根据业务场景选择：

1. 预加载（Eager Loading）：查询时一次性加载关联数据

这种方式会在查询主模型的同时，通过SQL JOIN语句一次性拉取关联数据，适合需要同时获取主模型和关联模型数据的场景：

// 查询单个用户及其关联的管理员，指定要加载的管理员属性
const userWithManager = await UserMaster.findOne({
  where: { UserId: 1 },
  include: [
    {
      model: Manager,
      as: 'manager', // 必须和关联定义的别名一致
      attributes: ['ManagerId', 'ManagerName'] // 只加载需要的属性，不写则加载所有
    }
  ]
})

// 访问关联属性
console.log(`用户 ${userWithManager.UserName} 的管理员是 ${userWithManager.manager.ManagerName}`)

如果要查询所有用户及其关联管理员：

const allUsersWithManagers = await UserMaster.findAll({
  include: [{ model: Manager, as: 'manager' }]
})

2. 懒加载（Lazy Loading）：先查主模型，再按需加载关联数据

这种方式先获取主模型实例，之后再根据需要加载关联数据，适合不需要立即获取关联数据的场景：

// 先获取用户实例
const user = await UserMaster.findByPk(1)

// 通过关联别名对应的方法加载管理员（方法名是 get[首字母大写的别名]）
const manager = await user.getManager()

// 访问管理员属性
console.log(`管理员姓名：${manager.ManagerName}`)

进阶技巧 #

• 筛选关联数据：你可以在include中添加where条件，只加载符合条件的关联模型：

const userWithSpecificManager = await UserMaster.findOne({
  where: { UserId: 1 },
  include: [
    {
      model: Manager,
      as: 'manager',
      where: { ManagerName: 'John Doe' }, // 只加载姓名为John Doe的管理员
      attributes: ['ManagerId']
    }
  ]
})

• 处理空关联：如果有些用户没有对应的管理员，添加required: false可以返回所有用户（类似SQL的LEFT JOIN）：

const usersWithOptionalManager = await UserMaster.findAll({
  include: [
    {
      model: Manager,
      as: 'manager',
      required: false // 即使没有关联的管理员，也会返回该用户
    }
  ]
})

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