516-frameworks-micronaut-mongodb-migrations-mongock

Micronaut - MongoDB 迁移（Mongock）

为 Micronaut 和 Micronaut Data MongoDB 应用 Mongock 迁移指南。

此 Skill 涵盖哪些内容？

• 为 Micronaut 项目选择 Mongock runner/driver
• 配置 Micronaut bean，以访问 MongoDB 客户端并控制迁移执行
• 使用 @Execution 和回滚钩子编写代码优先的 @ChangeUnit 迁移
• 锁定、幂等性、事务限制，以及启动时与运行时执行的权衡
• 使用 @MicronautTest 和 Testcontainers MongoDB 进行集成测试
• 与 @515-frameworks-micronaut-mongodb 协作

范围： 根据参考规则以及正反示例应用建议。

约束

在修改 Mongock 或 MongoDB 迁移之前先编译；修改后进行验证。

• 必须：应用任何更改前，运行 ./mvnw compile 或 mvn compile
• 安全：如果编译失败，立即停止
• 验证：应用改进后，运行 ./mvnw clean verify 或 mvn clean verify
• 应用前：阅读参考文档，了解详细规则和正反模式
• 边缘情况：如果 Micronaut 专用的 Mongock runner 不可用或不兼容，请使用显式的独立 runner bean/job，并说明这一权衡

何时使用此 Skill

• 在 Micronaut 中添加 Mongock 迁移
• 审查 Micronaut MongoDB 数据迁移
• 使用 Micronaut Data MongoDB 配置 Mongock change unit
• 为 Micronaut MongoDB 创建 Mongock change unit
• 审查 Micronaut 服务中的 Mongock 迁移顺序

工作流

1. 阅读参考文档并检查 MongoDB 设置

阅读 references/516-frameworks-micronaut-mongodb-migrations-mongock.md、references/516-frameworks-micronaut-mongodb-migrations-mongock-antipatterns.md 和 references/516-frameworks-micronaut-mongodb-migrations-mongock-parallel-change.md，然后检查 pom.xml、Micronaut MongoDB 配置，以及现有的 @515-frameworks-micronaut-mongodb 持久化模式。

2. 选择 runner、driver 和执行策略

选择兼容的 Mongock 坐标，通过 Micronaut bean 配置 runner，设置迁移扫描包，并决定是在启动时执行还是通过受控任务执行。

3. 应用符合框架规范的迁移

实现或重构 @ChangeUnit 类，确保操作幂等、顺序明确，并设置回滚钩子以及安全的锁定和事务配置。

4. 运行验证并报告结果

运行构建和测试；条件允许时，包括使用 Testcontainers MongoDB 的 @MicronautTest，并总结结果及后续风险。

参考

详细指南、示例和约束请参阅：

• references/516-frameworks-micronaut-mongodb-migrations-mongock.md
• references/516-frameworks-micronaut-mongodb-migrations-mongock-antipatterns.md
• references/516-frameworks-micronaut-mongodb-migrations-mongock-parallel-change.md