Sequelize findAll查询include块内使用sequelize.fn报错问题

Sequelize在include关联配置块中支持使用sequelize.fn定义聚合计算属性，你触发的PostgreSQL 42702（列引用歧义）错误并非功能不支持，而是聚合字段的写法不符合Sequelize的关联字段解析规则。

• 直接对billingdetails模型调用findAll写聚合逻辑时，Sequelize默认所有裸写的字段名归属当前查询的主表，会自动为字段追加表别名前缀，不会出现引用歧义。
• 在父模型billingsummary的include块中编写子表聚合逻辑时，如果你直接在sequelize.fn、sequelize.cast中传入字符串格式的字段名（如'createdAt'、'itemDiscount'），Sequelize的属性解析器不会自动识别该字段属于关联子表，不会追加bills.关联别名前缀。当主副表存在同名字段时，就会触发列引用歧义错误。

写法1：在父表查询的include块中实现聚合 #

核心规则：所有关联子表的字段引用，必须用sequelize.col()包裹，明确指定关联别名.字段名的路径，Sequelize才会正确解析字段归属。

const result = await billingsummary.findAll({
  include: [
    {
      model: billingdetails,
      as: 'bills',
      // 聚合字段全部用sequelize.col指定带别名的字段路径
      attributes: [
        [sequelize.fn('date_trunc', 'day', sequelize.col('bills.createdAt')), 'date'],
        [sequelize.fn('SUM', sequelize.cast(sequelize.col('bills.itemDiscount'), 'numeric')), 'NetDiscount'],
        [sequelize.fn('SUM', sequelize.cast(sequelize.col('bills.itemCredit'), 'numeric')), 'NetCredit'],
        [sequelize.fn('SUM', sequelize.cast(sequelize.col('bills.itemTax'), 'numeric')), 'NetTax'],
        [sequelize.fn('SUM', sequelize.cast(sequelize.col('bills.itemAmount'), 'numeric')), 'NetTotal']
      ],
      where: {
        createdAt: {
          [Op.gte]: startDate,
          [Op.lte]: endDate
        }
      }
    }
  ],
  // PostgreSQL要求GROUP BY必须包含所有非聚合字段，主表主键必须加入分组
  group: [
    'billingsummary.id',
    sequelize.col('date')
  ],
  raw: true,
  nest: true
})

写法2：反向以子表为主表查询（更简洁，推荐） #

如果你的核心需求是拿子表的聚合统计结果，不需要主表的大量字段，直接以billingdetails作为查询主表，反向关联billingsummary即可。这种写法下裸写子表字段会被自动识别，不需要反复追加关联别名，和你之前测试能正常运行的逻辑一致：

const result = await billingdetails.findAll({
  attributes: [
    [sequelize.fn('date_trunc', 'day', sequelize.col('createdAt')), 'date'],
    [sequelize.fn('SUM', sequelize.cast('itemDiscount', 'numeric')), 'NetDiscount'],
    [sequelize.fn('SUM', sequelize.cast('itemCredit', 'numeric')), 'NetCredit'],
    [sequelize.fn('SUM', sequelize.cast('itemTax', 'numeric')), 'NetTax'],
    [sequelize.fn('SUM', sequelize.cast('itemAmount', 'numeric')), 'NetTotal']
  ],
  include: [
    {
      model: billingsummary,
      as: 'billingSummary',
      attributes: [], // 不需要父表字段时传空数组即可
    }
  ],
  where: {
    createdAt: {
      [Op.gte]: startDate,
      [Op.lte]: endDate
    }
  },
  group: ['date'],
  raw: true
})

• 禁止在关联块的聚合函数中裸写字段名字符串，所有跨表字段必须通过sequelize.col()明确指定归属。
• PostgreSQL环境下的关联聚合查询，必须将主表非聚合主键加入group配置，否则会触发非聚合字段不在GROUP BY子句的报错。

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