Mongock是否支持JSON格式变更日志与运行时clusterId属性替换？

算力阿峰

2026-7-15

Mongock是否支持JSON格式变更日志及属性替换？

核心结论

Mongock原生不支持JSON/YAML这类声明式的变更日志格式，它的核心设计依赖Java/Kotlin的注解式变更集（@ChangeLog/@ChangeSet）或编程式变更逻辑，目前没有提供类似Liquibase的JSON变更日志解析能力。

针对需求的替代方案

1. 模拟JSON声明式效果（编程式API实现）

虽然不能直接用JSON文件定义变更日志，但可以自行解析JSON配置，再通过Mongock的编程式API执行变更逻辑：

读取你的JSON配置文件（包含变更集和待插入文档结构）
在注解式@ChangeSet方法中解析JSON，注入clusterId后执行MongoDB操作

示例代码：

@ChangeLog(order = "1")
public class IssueChangelog {

  private final Integer clusterId;

  // 通过构造器或@Value注入运行时clusterId
  public IssueChangelog(@Value("${clusterId}") Integer clusterId) {
    this.clusterId = clusterId;
  }

  @ChangeSet(id = "1", author = "admin", comment = "Populate ISSUES collection")
  public void populateIssues(MongoTemplate mongoTemplate) {
    // 模拟解析JSON后的文档构造逻辑
    List<Document> documents = Arrays.asList(
      new Document("CLUSTER_ID", clusterId)
        .append("LABEL", "defaultTag")
        .append("ORDER", 1),
      new Document("CLUSTER_ID", clusterId)
        .append("LABEL", "defaultIssue")
        .append("ORDER", 2)
    );
    mongoTemplate.insertMany(documents, "ISSUES");
  }
}