Sequelize关联嵌套表查询仅返回一条数据，但实际存在更多条目

可能原因及对应解决方案 #

1. 关联关系定义错误 #

如果Assignment模型与GameAssignment模型之间定义的是一对一关联（hasOne），而非一对多关联（hasMany），Sequelize只会返回一条关联的GameAssignment数据。

解决：
修正模型关联定义：

// Assignment 模型中设置一对多关联
Assignment.hasMany(GameAssignment, {
  foreignKey: 'assignment_id', // 替换为GameAssignment表中关联Assignment的实际外键字段
  as: 'game_assignments' // 需与查询include中的别名一致
});

// GameAssignment 模型对应关联
GameAssignment.belongsTo(Assignment, {
  foreignKey: 'assignment_id',
  as: 'assignment'
});

2. 关联外键不匹配 #

若GameAssignment表中存储的关联外键（如assignment_id）与Assignment的主键不对应，或模型关联定义的foreignKey参数错误，会导致仅匹配到部分关联数据。

解决：

• 确认GameAssignment表中关联Assignment的外键字段名称。
• 确保模型关联定义的foreignKey与数据库实际字段完全一致。

3. 查看实际执行的SQL语句 #

开启Sequelize日志功能，检查生成的SQL是否符合预期：

// 初始化Sequelize时开启日志
const sequelize = new Sequelize({
  // 其他配置项
  logging: console.log // 打印执行的SQL语句
});

执行查询后，确认生成的SQL为LEFT JOIN（因required: false），且结果集包含所有关联的GameAssignment数据。若SQL结果集有多条，但Sequelize返回的嵌套数组仅一条，大概率是关联关系定义错误。

4. 模型默认作用域过滤 #

若GameAssignment模型设置了defaultScope，可能会自动过滤部分数据，导致返回结果不全。

解决：
检查GameAssignment模型的defaultScope配置，若存在不必要的过滤条件，可移除或在查询中取消默认作用域：

include: [
  {
    model: GameAssignment,
    attributes: ['game_id'],
    required: false,
    scope: null // 取消默认作用域限制
  }
]

验证修改 #

修正上述问题后重新执行查询，即可返回所有关联的GameAssignment数据。

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