Sequelize查询多个同类型关联字段返回重复数据问题

这既不是Sequelize的已知功能限制，也不是框架Bug，是同模型多关联场景下的配置遗漏导致的映射错误。

当一个模型存在多个指向同一目标模型的BelongsTo关联时，Sequelize的默认关联推断逻辑无法自动区分每个关联对应的外键字段，会默认复用第一个匹配到的关联映射规则，最终导致所有同目标模型的关联都返回第一条匹配到的关联数据，也就是你遇到的重复问题。

修复方案 #

给每个指向ImagenProcess的关联显式配置外键、目标键和别名，不要依赖Sequelize的自动推断。修正后的UserCollection关联代码如下：

export class UserCollection extends Model<Partial<UserCollection>> {

    // actually the user nickname
    @Column({
        primaryKey: true,
        type: DataType.STRING,
        allowNull: false,
    })
    id!: string;

    @ForeignKey(() => ImagenProcess)
    @Column({
        type: DataType.UUID,
        allowNull: true,
    })
    uniqueImageId: string;
    @BelongsTo(() => ImagenProcess, {
        foreignKey: 'uniqueImageId',
        targetKey: 'id',
        as: 'uniqueImage'
    })
    uniqueImage: ImagenProcess

    @ForeignKey(() => ImagenProcess)
    @Column({
        type: DataType.UUID,
        allowNull: true,
    })
    commonImageId: string;
    @BelongsTo(() => ImagenProcess, {
        foreignKey: 'commonImageId',
        targetKey: 'id',
        as: 'commonImage'
    })
    commonImage: ImagenProcess

    // 你查询里用到的rareImage关联也需要按同样规则补全配置，否则会报关联不存在错误
    @ForeignKey(() => ImagenProcess)
    @Column({
        type: DataType.UUID,
        allowNull: true,
    })
    rareImageId: string;
    @BelongsTo(() => ImagenProcess, {
        foreignKey: 'rareImageId',
        targetKey: 'id',
        as: 'rareImage'
    })
    rareImage: ImagenProcess
}

ImagenProcess模型不需要做任何修改，保持原有主键配置即可。

查询验证 #

配置完成后，你原来的include写法可以正常运行，也可以用对象形式的include配置更明确地指定关联：

const userCollection = await UserCollection.findOne({
    where: { id },
    include: [
        { model: ImagenProcess, as: 'uniqueImage' },
        { model: ImagenProcess, as: 'rareImage' },
        { model: ImagenProcess, as: 'commonImage' },
    ]
})

重新执行查询后，三个关联会分别匹配对应的外键ID，返回正确的ImagenProcess记录，不会再出现数据重复的问题。

核心规则：只要同一个模型存在2个及以上指向同一目标模型的关联，就必须给每个关联显式指定foreignKey和as参数，否则Sequelize的关联映射一定会出现混乱。

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