Sequelize v6.6.5添加外键时出现「Fields must be specified through options.fields」错误排查

安全阿岳

2026-4-28

问题分析与解决方案

你遇到的错误确实是Sequelize版本差异导致的——Sequelize v6对addConstraint的API格式做了重大调整，和你参考的旧版本写法完全不兼容。

错误核心原因

在Sequelize v5及更早版本中，addConstraint的第二个参数可以直接传入字段数组，但v6开始要求所有字段配置必须通过options.fields来指定，不再支持独立的字段参数，这就是你看到「ERROR: Fields must be specified through options.fields」的直接原因。

适配Sequelize v6的修正代码

下面是调整后的正确迁移代码，我不仅修正了addConstraint的参数结构，还完善了down函数（原来的down只删除列但未清理外键约束，回滚时会触发数据库报错）：

module.exports = { 
  up: async (queryInterface, Sequelize) => {
    // 先添加关联字段，确保字段存在后再创建约束
    await queryInterface.addColumn('bonus_transactions', 'wallet_id', { 
      type: Sequelize.INTEGER.UNSIGNED, 
      allowNull: false, 
      after: 'order_id' 
    });
    // 外键约束配置：字段通过options.fields指定
    await queryInterface.addConstraint('bonus_transactions', { 
      fields: ['wallet_id'], // v6要求的字段配置位置
      type: 'FOREIGN KEY', 
      name: 'FK_bonus_transactions_wallet_id', 
      references: { 
        table: 'wallets', 
        field: 'id' 
      }, 
      onDelete: 'CASCADE' 
    });
  }, 
  down: async (queryInterface) => {
    // 必须先删除外键约束，再删除字段，否则数据库会因关联存在拒绝操作
    await queryInterface.removeConstraint('bonus_transactions', 'FK_bonus_transactions_wallet_id');
    await queryInterface.removeColumn('bonus_transactions', 'wallet_id');
  }
};