Sequelize HasMany关联嵌套查询仅返回单条关联记录问题

项目中定义了如下Sequelize模型关联关系：

class PurchaseOrders extends Model{
  static config(sequelize){
        //Configuration
    }
    
    static associate(models){
        this.hasMany(models.OrderItems, {
            as: 'orderItems', 
            foreignKey: 'purchaseOrderId'
        });
    }
}

class OrderItems extends Model{
  static config(sequelize){
        //Configuration
    }
    
    static associate(models){
        this.belongsTo(models.PurchaseOrders, {
            as: 'purchaseOrder',
            sourceKey: 'purchaseOrderId'
        });
    }
}

OrderItems.init(OrderItemsSchema, OrderItems.config(sequelize));
PurchaseOrders.init(PurchaseOrdersSchema, PurchaseOrders.config(sequelize));

OrderItems.associate(sequelize.models);
PurchaseOrders.associate(sequelize.models);

执行如下嵌套查询获取采购单及关联数据：

const rta = await models.PurchaseOrders.findAll({
    include: [
        {
            model: models.User,
            as: 'buyer'
        },
        {
            model: models.OrderItems,
            as: 'orderItems',
            required: true
        }
    ]
});

查询无报错，但一对多关联的orderItems字段仅返回第一条匹配的订单项记录，未返回采购单关联的全部订单项数据，不符合HasMany关联的预期返回结果。

核心问题是双向关联配置不匹配，OrderItems侧的belongsTo关联参数写错：

• Sequelize中sourceKey是hasMany/hasOne类型关联的专属参数，指源模型上用于和外键匹配的字段，默认是源模型主键，不能用在belongsTo配置中。
• belongsTo关联需要通过foreignKey指定当前模型上存储关联ID的字段，当前配置没有声明正确的外键，导致Sequelize关联映射逻辑异常，无法正确识别一对多关系，最终只拉取到第一条关联记录。

修正OrderItems模型的associate配置，和PurchaseOrders侧的hasMany外键声明对齐：

static associate(models){
    this.belongsTo(models.PurchaseOrders, {
        as: 'purchaseOrder',
        foreignKey: 'purchaseOrderId'
        // 无需额外指定targetKey，默认关联PurchaseOrders模型的主键即可
    });
}

修正后重启服务重新加载模型关联，再执行查询即可正常返回所有关联的订单项数据。

额外排查点：如果修正配置后仍只返回单条记录，检查数据库OrderItems表的purchaseOrderId字段是否误加了唯一索引，唯一索引会限制一个采购单ID只能对应一条订单项记录。

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