Sequelize关联查询中外键重复出现问题求助

问题场景 #

尝试通过Timeoff模型关联查询关联的User时，出现报错：error: column Timeoff.UserId does not exist，生成的SQL语句中同时出现了userId和大写的UserId两个外键字段。

Timeoff模型代码如下：

"use strict";
const { Model } = require("sequelize");
module.exports = (sequelize, DataTypes) => {
  class Timeoff extends Model {
    static associate(models) {
      Timeoff.belongsTo(models.User, {
        foreignKey: "userId",
      });
    }
  }
  Timeoff.init(
    {
      userId: DataTypes.INTEGER,
      date:DataTypes.DATEONLY
    },
    {
      sequelize,
      modelName: "Timeoff",
    }
  );

  Timeoff.findUsers = async (startDate, endDate) => {
    try {
      const object = await sequelize.models.Timeoff.findAll({
        include: {
          model: sequelize.models.User,
        },
      });

      return Promise.resolve(object);
    } catch (error) {
      return Promise.reject(error);
    }
  };

  return Timeoff;
};

后续测试发现：

• User模型使用以下关联代码时查询失败：

static associate(models) {
  User.hasMany(models.Timeoff);
}

• 但使用以下代码时查询成功：

static associate(models) {
  User.hasMany(models.Timeoff, {
    as: "timeoffs",
    foreignKey: "userId",
  });
}

原因分析 #

Sequelize的关联规则要求关联的两端配置必须匹配：

1. Timeoff模型的belongsTo已经明确指定了外键为userId
2. 当User模型的hasMany未指定foreignKey时，Sequelize会使用默认规则生成外键名：模型名+Id（即UserId）
3. 这种两端外键配置不匹配的情况，会让Sequelize误以为存在两个不同的外键关联，因此在生成SQL时同时包含了userId和UserId，而数据库表中实际只有userId字段，最终导致报错。

解决方案 #

确保关联的两端使用完全一致的外键配置：

1. 在Timeoff的belongsTo中保持已有的外键配置：

Timeoff.belongsTo(models.User, {
  foreignKey: "userId",
});

2. 在User的hasMany中必须指定相同的foreignKey值，同时可以通过as定义别名（可选，用于后续查询时指定关联名称）：

static associate(models) {
  User.hasMany(models.Timeoff, {
    foreignKey: "userId", // 与belongsTo端的外键保持一致
    as: "timeoffs" // 可选别名，提升代码可读性
  });
}

这样配置后，Sequelize会正确识别唯一的外键userId，生成的SQL中也只会包含该字段，查询即可正常执行。

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