如何为SQL格式Changeset设置Tag以执行Liquibase Maven回滚

一、SQL格式Changelog设置Tag的正确写法 #

SQL格式的changelog必须通过Liquibase专属注释指令来设置Tag，注意以下核心要求：

• 文件开头必须添加--liquibase formatted sql，明确告知Liquibase这是格式化的SQL changelog文件
• Tag指令单独占一行，格式为--tag:你的标签名，冒号后无空格，放置在需要标记的changeset执行代码之后

示例正确的SQL changelog文件：

--liquibase formatted sql
--changeset yusuf:1
CREATE TABLE users (
    id INT PRIMARY KEY AUTO_INCREMENT,
    username VARCHAR(50) NOT NULL
);

--tag:v1.0_initial_schema

二、逐项排查失效原因 #

结合你提供的databasechangelog表、changelog文件和pom配置，按以下步骤排查问题：

1. 检查changelog文件开头声明：如果没有--liquibase formatted sql，Liquibase会直接忽略所有注释类指令（包括--tag）
2. 验证Tag指令格式：确保是--tag:xxx而非--tag xxx或其他错误格式，且指令单独成行，没有和其他代码混排
3. 核对pom.xml插件配置：
   • 确认changeLogFile参数指向了正确的SQL文件路径
   • 检查是否误设置了skipTag或类似参数为true
   • 确保Liquibase插件版本与核心依赖版本兼容
4. 查看databasechangelog表：执行更新后，表中应出现一条TYPE='TAG'的记录；如果没有，说明Liquibase未识别到Tag指令
5. 确认执行命令：使用标准的mvn liquibase:update执行更新，避免使用跳过Tag处理的自定义命令

三、补打Tag的应急方案 #

如果之前的changeset已经执行完毕，现在需要补打Tag，可选择两种方式：

1. 用Maven命令补打：

mvn liquibase:tag -Dliquibase.tag=v1.0_initial_schema

2. 直接操作数据库插入Tag记录：

INSERT INTO databasechangelog (
    ID, AUTHOR, FILENAME, DATEEXECUTED, ORDEREXECUTED, 
    MD5SUM, DESCRIPTION, COMMENTS, EXECTYPE, LIQUIBASE, DEPLOYMENT_ID
) VALUES (
    'tag_v1.0', 'liquibase', 'tag', NOW(), 
    (SELECT MAX(ORDEREXECUTED)+1 FROM databasechangelog),
    '', 'Tag Database', 'v1.0_initial_schema', 'TAG', 
    '你的Liquibase版本号', (SELECT DEPLOYMENT_ID FROM databasechangelog LIMIT 1)
);

注意替换语句中的版本号和部署ID，确保与表中已有记录的格式一致。

内容的提问来源于stack exchange，提问作者Yusuf Özkan