如何在Sequelize中配置User与Wallet的可选关联关系？

针对你这个「同一邮箱对应多个User、每个邮箱最多一个Wallet，且部分User无关联Wallet」的需求，我来梳理下Sequelize里的具体配置方案，完全贴合你的业务场景：

1. 模型定义基础 #

首先要确保模型的email字段符合业务规则：

• User模型的email允许重复（同一邮箱可对应多个用户）
• Wallet模型的email必须唯一（每个邮箱仅对应一个钱包）

模型代码示例：

// User 模型
const User = sequelize.define('User', {
  id: {
    type: DataTypes.INTEGER,
    primaryKey: true,
    autoIncrement: true
  },
  siteId: DataTypes.INTEGER,
  email: DataTypes.STRING,
  // 其他业务字段...
});

// Wallet 模型
const Wallet = sequelize.define('Wallet', {
  id: {
    type: DataTypes.INTEGER,
    primaryKey: true,
    autoIncrement: true
  },
  email: {
    type: DataTypes.STRING,
    unique: true // 强制邮箱唯一，符合业务要求
  },
  // 其他业务字段...
});

2. 关联关系配置 #

业务逻辑是「一个Wallet对应多个User，一个User可能对应一个Wallet或无」，所以需要配置两组关联：

2.1 Wallet -> 多个User（一对多） #

在Wallet模型上配置hasMany关联，明确指定用email作为关联字段：

Wallet.hasMany(User, {
  sourceKey: 'email', // Wallet的关联字段是email
  foreignKey: 'email', // User的关联字段是email
  as: 'users', // 查询时的别名，方便获取关联数据
  onUpdate: 'CASCADE', // 可选：如果Wallet的email更新，同步更新User的email
  onDelete: 'SET NULL' // 可选：如果Wallet被删除，User的email保留（可根据业务调整）
});

2.2 User -> 可选Wallet（多对一） #

在User模型上配置belongsTo关联，同时设置required: false来兼容无关联的情况：

User.belongsTo(Wallet, {
  targetKey: 'email', // Wallet的匹配字段是email
  foreignKey: 'email', // User的关联字段是email
  as: 'wallet', // 查询时的别名
  required: false, // 关键配置：允许User没有对应的Wallet，查询时用LEFT JOIN而非INNER JOIN
  onUpdate: 'CASCADE',
  onDelete: 'SET NULL'
});

3. 查询示例 #

配置好关联后，就能轻松实现你的查询需求：

3.1 通过Wallet查询所有关联的User #

// 查询指定邮箱的Wallet，以及该邮箱下的所有User
const walletWithUsers = await Wallet.findOne({
  where: { email: 'user@example.com' },
  include: [{ model: User, as: 'users' }]
});

// 访问关联数据：walletWithUsers.users 就是该邮箱对应的所有User记录

3.2 通过User查询对应的Wallet（如果存在） #

// 查询指定User，同时获取其关联的Wallet（如果有）
const userWithWallet = await User.findOne({
  where: { id: 123 },
  include: [{ model: Wallet, as: 'wallet', required: false }]
});

// 如果该User的邮箱有对应的Wallet，userWithWallet.wallet 是Wallet对象；否则为null

注意事项 #

• 必须明确指定sourceKey和targetKey：Sequelize默认会用主键（id）做关联，我们这里要覆盖这个行为，指定用email字段关联。
• Wallet的email字段一定要加unique: true：确保每个邮箱只有一个Wallet，避免数据不一致。
• required: false是兼容无Wallet用户的核心：它会让Sequelize生成LEFT JOIN，这样即使User没有对应的Wallet，也能正常返回User数据。

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