使用Sequelize时自定义外键如何建立模型关联？

核心问题分析 #

你遇到的SequelizeEagerLoadingError本质是关联配置与查询逻辑不匹配，加上自定义外键未在双向关联中统一声明导致的。你的Listing表外键是user（而非Sequelize默认的userId），必须在关联配置中显式指定，同时查询时要对应关联的别名（如果设置了的话）。

正确的关联配置 #

需要在两个模型的关联中统一指定外键，双向关联（belongsTo + hasMany）都要配置，避免Sequelize自动查找默认字段：

1. Listing模型关联User

// Listing.js 或模型统一关联文件
Listing.belongsTo(User, {
  foreignKey: 'user', // 你的Listing表中实际的外键字段名
  targetKey: 'id',    // User表的关联主键（默认是id，可省略）
  as: 'user'          // 关联别名，需和查询include中的as对应
});

2. User模型关联Listing

// User.js 或模型统一关联文件
User.hasMany(Listing, {
  foreignKey: 'user', // 必须和Listing中的外键名一致，不能省略
  as: 'listings'      // 可选别名，用于从User查询其所有Listing时使用
});

查询代码的对应调整 #

如果关联时设置了as: 'user'，查询可以直接使用（或省略as，因为默认匹配模型小写名）：

const listings = await Listing.findAll({
  include: [{
    model: User,
    // as: 'user', // 关联时设置了as的话需要加上，没设置可以省略
    attributes: ['name', 'email']
  }]
});

如果你坚持用之前的as: 'userDetails'写法，查询必须严格对应别名：

// 关联配置（Listing.js）
Listing.belongsTo(User, {
  foreignKey: 'user',
  as: 'userDetails'
});

// 查询代码
const listings = await Listing.findAll({
  include: [{
    model: User,
    as: 'userDetails', // 必须和关联时的别名完全一致
    attributes: ['name', 'email']
  }]
});

为什么之前的写法报错？ #

• 你用User.hasMany(Listing)时未指定foreignKey，Sequelize会默认去Listing表找userId字段，但你的表实际是user，导致关联匹配失败，被误判为模型导入/导出问题。
• 第一种写法无报错但你不确定是否正确：如果查询时没加对应的as: 'userDetails'，其实查询结果里不会包含User数据，只是没触发报错而已，属于无效关联查询。

内容的提问来源于stack exchange，提问作者Bop 1ABot