Sequelize关联查询仅返回单个关联图片，无法获取全部图片数据问题排查

我完全理解你的困扰——明明数据库里存了多张关联图片，直接执行Sequelize生成的SQL能拿到全部结果，但框架返回的对象里却只有一张图片。结合你的代码和场景，我来帮你排查核心问题和解决方案：

一、优先检查ArticleImage模型的主键定义 #

这是最常见的触发原因！如果你的ArticleImage模型没有定义唯一主键，或者主键配置不正确，Sequelize在合并关联查询的多行结果时，无法区分不同的图片记录，会默认覆盖重复条目（通常只保留最后一条）。

比如如果你的ArticleImage模型是这样写的（缺少主键）：

const ArticleImage = sequelize.define('ArticleImage', {
  image: DataTypes.STRING,
  articleId: DataTypes.STRING
});

即使数据库里自动生成了主键，Sequelize如果没有显式识别到，也会在数据映射时出现异常。

解决方案：给ArticleImage显式添加唯一主键，推荐用UUID或者自增ID：

const ArticleImage = sequelize.define('ArticleImage', {
  id: {
    type: DataTypes.UUID,
    primaryKey: true,
    defaultValue: DataTypes.UUIDV4 // 自动生成唯一UUID
  },
  image: {
    type: DataTypes.STRING,
    allowNull: false
  },
  articleId: {
    type: DataTypes.STRING,
    allowNull: false
  }
});

同时确保数据库中的ArticleImages表也同步了这个主键字段。

二、尝试用findByPk替代findOne #

虽然findOne和findByPk功能类似，但findByPk是专门针对主键查询的方法，在处理关联数据的合并逻辑上更稳定。把你的查询代码改成下面这样试试：

const article = await Article.findByPk(articleId, {
  attributes: { exclude: ["titleTsVector", "userId"] },
  include: [
    // 其他关联配置保持不变
    {
      model: ArticleImage,
      attributes: ["image"]
    }
  ],
  benchmark: true,
  logging: function (sql, timeMs) {
    loggingService.emit("query-time-usage", { sql, timeMs });
  },
});

三、验证Sequelize的数据映射逻辑 #

你可以开启raw: true参数，查看Sequelize拿到的原始查询结果，确认是映射环节出了问题还是查询本身的问题：

const rawResult = await Article.findOne({
  where: { id: articleId },
  attributes: { exclude: ["titleTsVector", "userId"] },
  include: [/* 所有关联配置 */],
  raw: true
});
console.log(rawResult);

如果原始结果里能看到多个图片相关的字段（比如ArticleImages.0.image、ArticleImages.1.image），说明是Sequelize的映射逻辑异常；如果原始结果只有一张图，那就要重新检查关联配置，但根据你描述的SQL执行结果，这种情况概率很低。

四、检查主键类型一致性 #

确保Article模型的id字段类型和数据库完全匹配，比如数据库里是VARCHAR，Sequelize里就定义成DataTypes.STRING；如果是大整数，就用DataTypes.BIGINT。类型不匹配可能导致Sequelize合并结果时误判为不同的Article记录，只保留第一条数据。

总结一下：90%的概率是ArticleImage模型缺少唯一主键导致的，先补全主键配置应该就能解决问题。

内容来源于stack exchange