Sequelize关联查询在父记录属性中添加子记录计数的问题排查

• 分组规则错误：你在group中加入了comments.id，左连接后每一条「帖子+单条评论」的组合会被单独分为一组，count统计的是单组内的行数，自然返回固定值1。
• 聚合函数写法错误：直接给fn('count')传字符串'comments.id'，最终生成的SQL是count('comments.id')，统计的是字符串常量而非评论表的id字段，这也是0评论帖子也返回计数1的核心原因。
• 聚合逻辑和明细拉取冲突：在同一个关联查询中同时做分组聚合、拉取全量关联评论明细，会产生笛卡尔积问题，Sequelize无法正确完成结果组装。

首先从Sequelize中补充引入字段引用方法col，再调整查询配置：

// 补充引入col，需要做范围筛选时再加Op
const { fn, col, Op } = Sequelize;

let criteria = {
  attributes: {
    include: [
      // 正确引用评论表id字段做计数
      [fn('COUNT', col('comments.id')), 'TotalComments']
    ]
  },
  include: [
    {
      model: Comments,
      // 开启独立查询拉取评论明细，和主表聚合逻辑隔离，避免笛卡尔积冲突
      separate: true
    }
  ],
  // 仅按帖子主表主键分组即可
  group: ['posts.id'],
  // 后续需要按评论数筛选时，直接加having条件即可，例如筛选评论数2-4的帖子：
  // having: {
  //   TotalComments: { [Op.between]: [2, 4] }
  // }
}

方案说明 #

• 开启separate: true后，Sequelize会拆分两条查询执行：第一条查询帖子主表数据+聚合统计评论总数，第二条批量拉取所有符合条件帖子关联的评论，自动按外键匹配组装到对应帖子的comments数组下，既不会影响聚合计数的准确性，也比关联拉取笛卡尔积的执行效率更高。
• 聚合计数使用col('comments.id')引用字段，左连接无评论时该字段为NULL，COUNT会自动忽略NULL值，0评论帖子会正确返回计数0。

执行后即可得到预期返回结果，TotalComments会和实际评论数量完全匹配，也支持后续直接基于该字段做筛选。

内容的提问来源于stack exchange，提问作者Zain Ul Abidin