Sequelize迁移问题：MSSQL中无法修改列的关联引用

我用MSSQL数据库，最初通过下面的Sequelize迁移脚本创建了表：

module.exports = {
  up: function(queryInterface) {
    return queryInterface.createTable(
      'tablename',
      {
        'column1': {
          type: SEQUELIZE.INTEGER,
          references: {
            model: 'Foobar',
            key: 'id',
            onDelete: 'cascade'
          }
        }
      }
    )
  }
};

后来我想修改column1的关联目标，写了这样的迁移脚本：

module.exports = {
  up: function(queryInterface) {
    return queryInterface.changeColumn(
      'tablename',
      'column1',
      {
        type: SEQUELIZE.INTEGER,
        references: {
          model: 'BarFoo', // 修改了关联目标表
          key: 'id',
          onDelete: 'cascade'
        }
      }
    )
  }
};

执行sequelize db:migrate后显示迁移成功，但数据库里column1还是关联旧表Foobar，根本没更新到BarFoo，这是为啥？

原因分析与解决方案 #

核心原因 #

Sequelize的changeColumn方法在MSSQL数据库环境下，不会自动处理外键约束的变更。它主要负责修改列的基础属性（比如数据类型、默认值、是否允许为空等），而外键约束属于独立的数据库对象，changeColumn里的references配置并不会触发旧约束的删除和新约束的创建——这是Sequelize针对MSSQL的一个已知行为。

正确的解决步骤 #

要修改外键关联，你需要手动删除旧的外键约束，再添加新的约束。具体操作如下：

1. 找到旧外键约束的名称
   MSSQL会自动为外键生成约束名，通常格式类似FK_tablename_column1_Foobar_id。你可以通过查询数据库找到它：

   SELECT name FROM sys.foreign_keys 
   WHERE parent_object_id = OBJECT_ID('tablename')
   AND referenced_object_id = OBJECT_ID('Foobar');
   

2. 编写完整的迁移脚本
   用removeConstraint删除旧约束，再用addConstraint添加新的关联约束：

   module.exports = {
     up: async function(queryInterface) {
       // 先删除旧的外键约束，替换成你查到的实际约束名
       await queryInterface.removeConstraint('tablename', 'FK_tablename_column1_Foobar_id');
       
       // 添加新的外键约束，关联到BarFoo表
       await queryInterface.addConstraint('tablename', {
         fields: ['column1'],
         type: 'foreign key',
         name: 'FK_tablename_column1_BarFoo_id', // 自定义新约束名，可选
         references: {
           table: 'BarFoo',
           field: 'id'
         },
         onDelete: 'cascade'
       });
     },
   
     // 可选：编写回滚逻辑
     down: async function(queryInterface) {
       await queryInterface.removeConstraint('tablename', 'FK_tablename_column1_BarFoo_id');
       await queryInterface.addConstraint('tablename', {
         fields: ['column1'],
         type: 'foreign key',
         name: 'FK_tablename_column1_Foobar_id',
         references: {
           table: 'Foobar',
           field: 'id'
         },
         onDelete: 'cascade'
       });
     }
   };
   

额外说明 #

• 如果不确定旧约束名，也可以在迁移里先查询获取，但为了稳定性，建议提前在数据库里确认好约束名再写进脚本。
• 这个问题只在MSSQL下比较突出，部分其他数据库（比如PostgreSQL）可能会有不同的表现，但显式操作约束是跨数据库的稳妥做法。

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