用途:在 Micronaut 与 Micronaut Data MongoDB 项目中应用 Mongock 迁移规范,添加或审查 MongoDB 数据迁移。
主要能力:选择适用于 Micronaut 的 Mongock runner/driver;通过 Micronaut bean 装配 MongoDB 客户端访问并控制迁移执行;编写 code-first 的 @ChangeUnit 迁移,配合 @Execution 与回滚钩子;处理锁定、幂等性、事务限制以及启动期与运行期执行的权衡;使用 @MicronautTest 与 Testcontainers MongoDB 编写集成测试;与 @515-frameworks-micronaut-mongodb 协调。
使用方式:先阅读 references/516-frameworks-micronaut-mongodb-migrations-mongock.md、其 antipatterns 与 parallel-change 文档,检查 pom.xml、Micronaut MongoDB 配置及既有持久化模式;选择兼容的 Mongock 坐标,通过 Micronaut bean 装配 runner,配置迁移扫描包,决定启动时执行还是受控任务执行;实现 @ChangeUnit 类,保证操作幂等、顺序明确、含回滚钩子并设置安全的锁与事务参数。
必要命令(保持原样):变更前运行 ./mvnw compile 或 mvn compile;编译失败立即停止;改进后运行 ./mvnw clean verify 或 mvn clean verify。
限制:需遵循参考规则与好坏示例。若 Micronaut 专用 Mongock runner 不可用或不兼容,可使用显式独立 runner bean/job,并记录该取舍。