513-frameworks-micronaut-db-migrations-flyway

Micronaut — 数据库迁移（Flyway）

为 Micronaut 应用 Flyway 迁移指南。

此技能涵盖哪些内容？

• 使用 JDBC/Hikari 和数据库驱动的 micronaut-flyway
• src/main/resources/db/migration 下的版本化 SQL
• YAML/properties 中的 flyway.datasources.*（按数据源配置）
• 使用 Testcontainers 和真实迁移链进行测试
• 将并行变更（Parallel Change）作为安全的扩展、迁移、收缩工作流，用于具有破坏性或对数据敏感的架构变更
• 与 @511-frameworks-micronaut-jdbc 和 @512-frameworks-micronaut-data 协同

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

约束

在应用 Flyway 或 SQL 变更之前，确保项目能够编译。改进后，运行完整验证。

• 强制要求：应用任何变更之前，运行 ./mvnw compile 或 mvn compile
• 安全要求：如果编译失败，立即停止
• 验证要求：应用改进后，运行 ./mvnw clean verify 或 mvn clean verify
• 应用变更前：阅读参考资料，了解详细规则和正反模式
• 破坏性变更审查：在建议或应用迁移之前，评估它是否可能破坏已部署的应用版本、依赖服务、报告、作业，或影响生产数据的解读；如果会，则必须先由人工明确审查
• 边界情况：如果用户的目标不明确，在编辑文件或运行项目范围的命令之前，停止并提出澄清问题
• 边界情况：如果缺少必要的上下文、文件、凭证或工具，请明确说明阻碍，并询问是否继续进行设置或提供替代指导
• 边界情况：如果请求的变更与项目约束或安全边界冲突，请说明冲突，并询问用户希望采用哪种权衡方案

何时使用此技能

• 在 Micronaut 项目中添加或审查 Flyway 迁移
• 配置 micronaut-flyway 或 db/migration 目录布局
• 为 Micronaut 添加版本化 Flyway SQL 迁移
• 审查 Micronaut 数据库迁移顺序
• 在 Micronaut 项目中配置 Flyway 数据源

工作流

1. 阅读参考资料并评估项目上下文

阅读 references/513-frameworks-micronaut-db-migrations-flyway.md、references/513-frameworks-micronaut-db-migrations-flyway-antipatterns.md 和 references/513-frameworks-micronaut-db-migrations-flyway-parallel-change.md，然后检查当前项目设置，再提出变更建议。

2. 确定范围并选定目标改进

明确所需结果和约束，并确定要应用的最小安全变更集。

3. 应用符合框架要求的变更

按照参考模式和项目惯例实现或重构配置/代码。对于具有破坏性或对数据敏感的架构变更，默认采用并行变更（扩展、迁移、收缩）这一安全做法。

4. 运行验证并报告结果

执行适当的构建/测试，并总结变更内容、验证结果以及任何后续操作。

参考资料

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

• references/513-frameworks-micronaut-db-migrations-flyway.md
• references/513-frameworks-micronaut-db-migrations-flyway-antipatterns.md
• references/513-frameworks-micronaut-db-migrations-flyway-parallel-change.md