使用Sequelize迁移SQLite时PostVotes表插入数据报外键不匹配错误

问题根源 #

SQLite对外国键引用有严格限制：如果被引用的表使用复合主键，外键必须完整引用所有主键字段，不能仅引用部分字段。
你的Posts表迁移配置存在错误：已单独设置id为主键，又额外给userId添加了primaryKey: true属性，导致Posts最终生成的是id + userId的复合主键。而PostVotes的postId字段仅引用了Posts.id，不符合SQLite外键规则，因此触发foreign key mismatch报错。

sequelize.sync()未触发报错的原因是sync逻辑按你的模型定义建表，大概率你的模型中Posts的userId没有配置primaryKey: true，不会生成复合主键，因此不存在外键匹配问题。

修复步骤 #

• 调整Posts表迁移配置，删除userId字段下的primaryKey: true配置，仅保留id作为唯一主键
• （可选优化）调整PostVotes表主键配置，二选一即可：
  • 保留独立id作为主键：删除userId、postId字段下的primaryKey: true配置，可额外添加userId + postId的联合唯一约束避免同一用户对同一帖子重复投票
  • 移除冗余id字段：直接使用userId + postId作为联合主键，更符合关联中间表的设计规范

修复后代码示例 #

调整后的Posts表迁移代码 #

queryInterface.createTable('Posts', {
  id: {
    allowNull: false,
    primaryKey: true,
    type: Sequelize.UUID,
    defaultValue: Sequelize.UUIDV4,
  },
  title: {
    type: Sequelize.STRING,
    allowNull: false,
  },
  userId: {
    type: Sequelize.UUID,
    onDelete: 'CASCADE',
    references: {
      model: 'Users',
      key: 'id',
    },
  },
}),

调整后的PostVotes表迁移代码（保留独立id版本） #

queryInterface.createTable('PostVotes', {
  id: {
    allowNull: false,
    primaryKey: true,
    type: Sequelize.UUID,
    defaultValue: Sequelize.UUIDV4,
  },
  vote: {
    // eslint-disable-next-line new-cap
    type: Sequelize.ENUM('up', 'down'),
    validate: {
      isIn: [['up', 'down']],
    },
    allowNull: false,
  },
  userId: {
    type: Sequelize.UUID,
    onDelete: 'CASCADE',
    references: {
      model: 'Users',
      key: 'id',
    },
  },
  postId: {
    type: Sequelize.UUID,
    onDelete: 'CASCADE',
    references: {
      model: 'Posts',
      key: 'id',
    },
  },
}, {
  // 可选配置：添加联合唯一约束避免重复投票
  uniqueKeys: {
    user_post_vote_unique: {
      fields: ['userId', 'postId']
    }
  }
}),

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