Sequelize中如何基于外键关联的非主键字段插入数据？

这个问题我之前也碰到过，本质是你搞混了外键关联的字段类型——Book表的author字段是关联Author的id（数字类型），但你传了uuid（字符串类型），ORM自然会报错。下面给你几个可行的解决办法：

方法一：先通过uuid查询作者id，再插入书籍 #

这是最直接的方案，先根据uuid找到对应的Author记录，拿到它的id后再插入Book：

// 第一步：根据uuid查询对应的作者
const targetAuthor = await models.Author.findOne({
  where: { uuid: "xyz" }
});

// 先判断作者是否存在，避免后续报错
if (!targetAuthor) {
  throw new Error("指定uuid的作者不存在");
}

// 第二步：使用作者的id插入书籍
const book = await models.Book.create({
  title: "Space",
  timestamp: 562,
  author: targetAuthor.id // 这里传入的是数字类型的id，匹配外键要求
});

方法二：利用ORM的关联特性直接关联插入 #

如果你的模型已经定义了Book和Author的关联关系（比如Book.belongsTo(models.Author, { foreignKey: 'author' })），可以直接通过关联对象的方式插入，ORM会自动帮你处理id的映射：

// 假设已经在模型中定义了Book与Author的关联
const book = await models.Book.create(
  {
    title: "Space",
    timestamp: 562,
    // 通过关联模型的uuid匹配已有作者
    Author: { uuid: "xyz" }
  },
  {
    // 指定要包含的关联模型，让ORM识别关联关系
    include: [models.Author]
  }
);

注意：这种方式要求Author记录已经存在，如果需要自动创建不存在的作者，可以结合findOrCreate逻辑调整。

方法三：修改外键关联为uuid（长期方案） #

如果你的业务更倾向于用uuid作为关联标识，可以修改数据库结构和模型配置：

1. 修改Book表的author字段类型为字符串（和Author的uuid类型一致）
2. 在模型中重新配置关联，让Book的外键指向Author的uuid而非id：

// 在Book模型中修改关联配置
Book.belongsTo(models.Author, {
  foreignKey: 'author',
  targetKey: 'uuid' // 指定关联的是Author的uuid字段
});

修改完成后，你最初的代码就可以直接运行了，不需要额外查询。

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