使用Sequelize+Express时关联查询仅返回单条关联记录的问题

当使用 raw: true 配置查询带有 hasMany 关联的模型时，Sequelize 不会自动将多条关联记录转换为数组——因为 raw: true 会跳过 ORM 层的关联合并逻辑，直接返回数据库 JOIN 查询的原始结果（每条关联地址对应一行用户数据），而 nest: true 仅能将嵌套字段转为对象，无法处理多条记录的数组转换。

解决方法一：用 findAll 查询后合并结果 #

通过 findAll 获取所有关联行，再合并为单个用户对象并将地址转为数组，这是最可靠的方式：

const userRows = await sequelize.users.findAll({
  where: {...},
  include: [{ model: shipping_addresses, as: 'shipping_addresses' }],
  raw: true
});

if (userRows.length === 0) return null;

// 初始化用户基础信息
const processedUser = {
  id: userRows[0].id,
  username: userRows[0].username,
  shipping_addresses: []
};

// 遍历所有行，合并地址记录
userRows.forEach(row => {
  const address = {
    id: row['shipping_addresses.id'],
    line: row['shipping_addresses.line']
  };
  // 避免重复添加同一地址
  if (!processedUser.shipping_addresses.find(addr => addr.id === address.id)) {
    processedUser.shipping_addresses.push(address);
  }
});

解决方法二：手动处理单条查询结果（限已知地址数量场景） #

如果确定用户只有少量地址，也可以关闭 nest: true 获取扁平数据后手动提取：

const user = await sequelize.users.findOne({
  where: {...},
  include: [{ model: shipping_addresses, as: 'shipping_addresses' }],
  raw: true
});

if (!user) return null;

const processedUser = {
  id: user.id,
  username: user.username,
  shipping_addresses: []
};

// 提取当前行的地址信息
const address = {
  id: user['shipping_addresses.id'],
  line: user['shipping_addresses.line']
};
processedUser.shipping_addresses.push(address);

// 注意：findOne 仅会返回 JOIN 结果的最后一行，若有多个地址需用 findAll 处理

关键说明 #

raw: true 会让 Sequelize 直接返回数据库的原始查询结果，而数据库的 JOIN 操作会为每个关联地址生成一条用户数据行。ORM 层原本会自动合并这些行，但 raw: true 跳过了这个步骤，所以必须手动处理多行数据的合并，才能得到包含地址数组的用户对象。

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