Sequelize关联查询报错：未知列wp_postmeta.ID问题排查

数据表结构 #

table: wp_posts 
PK ID
post_title

table: wp_postmeta 
PK post_id
meta_key
meta_value

执行的Sequelize代码 #

wp_posts.hasMany(wp_postmeta, { foreignKey: "post_id" });
wp_postmeta.belongsTo(wp_posts, { foreignKey: "ID" });

wpPostsData = await wp_posts.findAll({
  include: [wp_postmeta]
});

生成的SQL语句 #

Executing (default): SELECT `wp_posts`.`ID`, `wp_posts`.`post_author`, `wp_posts`.`post_title`, `wp_postmeta`.`post_id` AS `wp_postmeta.post_id`, `wp_postmeta`.`meta_key` AS `wp_postmeta.meta_key`, `wp_postmeta`.`meta_value` AS `wp_postmeta.meta_value`, `wp_postmeta`.`ID` AS `wp_postmeta.ID` FROM `wp_posts` AS `wp_posts` LEFT OUTER JOIN `wp_postmeta` AS `wp_postmeta` ON `wp_posts`.`ID` = `wp_postmeta`.`post_id` WHERE `wp_posts`.`post_type` = 'product';

错误信息 #

parent: Error: Unknown column 'wp_postmeta.ID' in 'fie…    at Packet.asError (c:\Users\yonatan\OneD…, original: Error: Unknown column 'wp_postmeta.ID' in 'fi…   at Packet.asError (c:\Users\yonatan\OneD…, sql: 'SELECT `wp_posts`.`ID`, `wp_posts`.`post_autho…_id` WHERE `wp_posts`.`post_type` = 'product';', parameters: {…}, …}

原因分析 #

1. 默认主键规则冲突：Sequelize默认会假设每个模型都有ID作为主键字段，如果你在定义wp_postmeta模型时没有明确指定主键为post_id，它就会自动尝试查询这个不存在的ID字段。
2. 关联配置参数错误：wp_postmeta.belongsTo的foreignKey参数设置错误，该参数指向的是当前模型（wp_postmeta）中关联父模型的字段，应该是post_id，而非父模型的主键ID。

解决办法 #

1. 修正wp_postmeta模型定义 #

明确指定表的主键为post_id，让Sequelize识别正确的主键字段：

const wp_postmeta = sequelize.define('wp_postmeta', {
  post_id: {
    type: DataTypes.INTEGER,
    primaryKey: true // 标记该字段为主键
  },
  meta_key: DataTypes.STRING,
  meta_value: DataTypes.TEXT
}, {
  timestamps: false, // 若wp_postmeta表无created_at/updated_at字段，必须添加此项
  tableName: 'wp_postmeta' // 确保模型与数据库表名对应
});

2. 修正关联配置 #

调整belongsTo的参数，明确外键和目标键：

wp_posts.hasMany(wp_postmeta, { foreignKey: "post_id" });
wp_postmeta.belongsTo(wp_posts, { 
  foreignKey: "post_id", // wp_postmeta中用于关联的字段
  targetKey: "ID" // wp_posts的主键字段
});

3. 可选：临时指定查询字段 #

如果暂时无法修改模型定义，可以在查询时明确指定要获取的字段，避免Sequelize自动添加不存在的wp_postmeta.ID：

wpPostsData = await wp_posts.findAll({
  include: [{
    model: wp_postmeta,
    attributes: ['post_id', 'meta_key', 'meta_value'] // 仅查询表中存在的字段
  }]
});

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