如何在Flyway中实现MySQL 8.0表的幂等安全重命名

问题本质 #

MySQL自带的RENAME TABLE语法没有条件判断能力，既不知道原表aaa是不是已经被重命名过，也不管目标表bbb是不是已经存在，直接跑的话二次执行必然触发1050“表已存在”的报错，完全不满足多环境、多轮部署的幂等要求。
这里必须先记牢Flyway的核心规则：只要是在某个环境里成功执行过的版本迁移脚本，绝对不能改原文件内容——Flyway会逐行计算脚本的校验和，改完直接导致应用启动失败。需要根据当前V7脚本的部署进度选对应的处理方式。

方案1：V7重命名脚本尚处于开发阶段、未在生产环境落地 #

可以直接修改原V7脚本内容，通过存储过程做前置条件校验，实现任意次数运行都不报错的幂等效果，具体代码如下：

-- 清理可能遗留的临时存储过程对象
DROP PROCEDURE IF EXISTS sp_safe_rename_aaa_to_bbb;

-- 修改语句分隔符，避免存储过程内的分号和全局分隔符冲突
DELIMITER //
CREATE PROCEDURE sp_safe_rename_aaa_to_bbb()
BEGIN
    -- 同时满足两个条件才执行重命名：
    -- 1. 当前库下原表aaa真实存在
    -- 2. 当前库下目标表bbb不存在
    IF (
        SELECT COUNT(*) 
        FROM information_schema.TABLES 
        WHERE TABLE_SCHEMA = DATABASE() 
          AND TABLE_NAME = 'aaa'
    ) = 1
    AND (
        SELECT COUNT(*) 
        FROM information_schema.TABLES 
        WHERE TABLE_SCHEMA = DATABASE() 
          AND TABLE_NAME = 'bbb'
    ) = 0
    THEN
        RENAME TABLE aaa TO bbb;
    END IF;
END //
-- 恢复默认语句分隔符
DELIMITER ;

-- 执行安全重命名逻辑
CALL sp_safe_rename_aaa_to_bbb();

-- 清理临时存储过程，不遗留额外数据库对象
DROP PROCEDURE IF EXISTS sp_safe_rename_aaa_to_bbb;

这套逻辑的运行表现：

• 第一次执行：aaa存在、bbb不存在，正常完成重命名
• 第二次及后续执行：aaa不存在、bbb存在，直接跳过逻辑，不会触发任何报错
• 异常中断场景（比如第一次重命名执行到一半失败）：如果aaa和bbb同时存在，逻辑会跳过执行，不会强行覆盖已有表数据，避免数据丢失

方案2：V7脚本已经在任意生产/测试环境成功执行过 #

绝对不能修改原V7脚本的内容，只需要新增一个版本号更高的迁移脚本（比如命名为V8__fix_rename_aaa_to_bbb_idempotent.sql），把上面的安全重命名逻辑放到新脚本中即可。Flyway在后续部署时会自动执行这个新脚本，兼容所有环境的状态差异。

需要规避的常见错误操作 #

• 不要图省事写DROP TABLE IF EXISTS bbb; RENAME TABLE aaa TO bbb;：这会直接删除已经存在的bbb表数据，生产环境会造成不可逆的数据丢失
• 不要尝试给RENAME语句加IF EXISTS/IF NOT EXISTS关键字：MySQL 8.0的RENAME语法本身不支持这类条件判断，写了会直接触发语法错误
• 查询information_schema的时候必须加上TABLE_SCHEMA = DATABASE()过滤条件：否则会把其他数据库下的同名表纳入判断，出现逻辑误判

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