Sequelize迁移执行完成但数据库未变更，求排查方案

核心问题 #

你的迁移代码未等待异步数据库操作完成：queryInterface.renameColumn是异步方法（返回Promise），但你在up和down函数里没有用await关键字，导致迁移进程在数据库执行重命名命令前就已结束，列名根本没被修改。

修复后的迁移代码 #

const tableName= 'aTable';

module.exports = {
    up: async (queryInterface, Sequelize) => {
        await queryInterface.renameColumn(tableName, 'oldName', 'newName');
    },

    down: async (queryInterface, Sequelize) => {
        await queryInterface.renameColumn(tableName, 'newName', 'oldName');
    },
};

Sequelize调试方法 #

• 开启SQL日志：在Sequelize配置中添加logging: console.log，迁移时会打印所有执行的SQL语句，可直接确认重命名命令是否被发送到数据库。
• 排查事务问题：Sequelize迁移默认使用事务，若操作中存在未捕获的错误会自动回滚。可在迁移函数中添加try/catch捕获异常，或临时关闭事务（设置transaction: false）排查是否有隐藏错误。
• 手动验证SQL：直接在PostgreSQL客户端执行ALTER TABLE "aTable" RENAME COLUMN "oldName" TO "newName";，验证数据库权限、表/列名大小写是否匹配（PostgreSQL对带引号的标识符大小写敏感）。
• 检查迁移历史表：查看Sequelize自动生成的SequelizeMeta（或小写sequelizemeta）表，确认当前迁移是否被标记为已执行，避免重复执行或记录异常的情况。

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