1. Flyway 概述：Flyway 是什么、核心价值、版本迁移的基本概念与工作流程

1.1 什么是 Flyway

Flyway 是一款开源的数据库版本控制工具，采用 “约定优于配置” 的设计哲学，通过版本化的 SQL 脚本或 Java 迁移类，对数据库 Schema 进行可重复、可追溯的变更管理。它本质上是一个 数据库 Schema 的 Git，让每一次 DDL/DML 变更都像代码提交一样被记录、校验和回放。

1.2 核心价值

• 可重复性：开发、测试、生产环境执行同一套迁移脚本，消除“在我机器上能跑”的 Schema 差异。
• 可追溯性：每次迁移的校验和（Checksum）、执行时间、执行人、脚本内容全部记录在 flyway_schema_history 表中，形成完整的审计链路。
• 幂等性：通过版本号唯一性保证同一脚本不会重复执行；失败时支持清理（Clean）和修复（Repair）操作。
• CI/CD 集成：可嵌入构建流水线，在应用部署前自动完成 Schema 升级，避免人工漏跑或错跑脚本。
• 团队协作：多人并行开发时，通过版本号冲突检测和基线（Baseline）机制，减少 Schema 合并冲突。

1.3 版本迁移的基本概念

迁移文件命名规范：

前缀 + 版本号 + 分隔符 + 描述 + 后缀

示例：
V1__create_user_table.sql
V2_1__add_email_column.sql
V3__insert_initial_data.sql
R__my_view.sql          （重复迁移，无版本号）
U1__undo_create_user_table.sql  （撤销迁移，企业版）

1.4 工作流程

Flyway 的迁移执行遵循 “检查 → 校验 → 执行 → 记录” 的闭环流程，具体步骤如下：

1. 扫描：Flyway 扫描配置的迁移路径（默认 classpath:db/migration），解析所有迁移文件的版本号和校验和。
2. 校验：读取目标数据库的 flyway_schema_history 表，对比已执行迁移的校验和是否与本地文件一致。不一致则抛出异常，阻止迁移。
3. 排序：按版本号升序排列未执行的迁移，确定执行顺序。
4. 锁定：在集群或多实例部署场景下，通过数据库锁（或表锁）确保同一时刻只有一个实例执行迁移，避免并发冲突。
5. 执行：依次执行每个迁移脚本。SQL 迁移在事务内执行（如果数据库支持 DDL 事务）；Java 迁移由开发者控制事务边界。
6. 记录：每个迁移执行成功后，在 flyway_schema_history 表中插入一条记录，包含版本号、描述、校验和、执行时间、脚本内容（可选）。
7. 完成：所有待执行迁移执行完毕后，释放锁，返回迁移结果。

1.5 迁移类型对比

1.6 元数据表结构

flyway_schema_history 表是 Flyway 的“大脑”，记录了所有迁移的执行历史。其核心字段如下：