Liquibase PRO为MongoDB特定changeSet添加标签失败问题排查

问题原因分析 #

1. 在runWith: mongosh的changeSet内混用tagDatabase报错
   带runWith: mongosh的changeSet是Liquibase专为执行Mongo Shell脚本设计的上下文，仅支持mongosh类型的变更操作，不兼容Liquibase标准的tagDatabase这类变更指令，直接混用会触发“变更类型不支持”的报错。

2. 独立标签changeSet未关联目标changeSet
   单独创建的标签changeSet如果没有设置执行依赖，会和目标changeSet（id: add_game_interests）的执行流程完全独立，无法保证标签在目标changeSet执行后添加，自然无法形成关联关系。

可行解决方案 #

通过runAfterChangeSets属性给标签changeSet设置执行依赖，确保它仅在目标changeSet成功执行后才运行，从而实现标签与目标changeSet的强关联。

示例代码

1. 目标Mongo Shell changeSet：

<changeSet id="add_game_interests" author="your-username" runWith="mongosh">
    <comment>创建游戏兴趣集合及唯一索引</comment>
    <mongosh>
        db.createCollection("game_interests");
        db.game_interests.createIndex({userId: 1, gameId: 1}, {unique: true});
    </mongosh>
</changeSet>

2. 关联目标changeSet的标签changeSet：

<changeSet id="tag_post_add_game_interests" author="your-username">
    <!-- 指定仅在目标changeSet执行后运行 -->
    <runAfterChangeSets>
        <changeSetId>add_game_interests</changeSetId>
    </runAfterChangeSets>
    <!-- 添加关联标签 -->
    <tagDatabase tag="v1.1.0_game_interests_added"/>
</changeSet>

补充说明 #

Liquibase的标签本质是在DATABASECHANGELOG表中添加一条标记记录，不会直接绑定到单个changeSet，但通过runAfterChangeSets的依赖控制，可以确保标签的添加与目标changeSet的执行完全绑定。后续你可以通过该标签快速定位到目标changeSet执行后的数据库状态，达到“关联特定changeSet”的实际需求。

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