flyway数据库迁移

### Flyway 数据库迁移使用指南

#### 创建并初始化项目环境
为了使Flyway能够正常工作，在项目环境中需配置好相应的依赖项。对于Maven项目，可以在`pom.xml`文件中加入如下依赖：

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
    <version>${flyway.version}</version>
</dependency>

当首次运行Flyway指向一个空数据库时，将会自动创建名为`flyway_schema_history`的表格用于记录每次执行过的SQL脚本及其状态信息[^1]。

#### 编写迁移脚本
所有的迁移脚本应放置于特定目录下，默认路径为`src/main/resources/db/migration`。这些脚本按照命名约定编写，通常格式为`V__Description.sql`，其中`V`代表版本号，而`Description`是对该次变更简单描述的文字说明。例如:

- `V1__Create_person_table.sql`: 定义了创建人员表结构；
- `V2__Add_age_column_to_person.sql`: 向已有人员表增加年龄字段；

每条语句都应当独立成行，并且确保语法正确无误以便顺利通过解析器验证。

#### 执行迁移命令
可以通过多种方式触发实际的数据迁移过程，比如直接调用API接口、利用Spring Boot内置支持或是借助CLI客户端工具完成操作。下面给出一段基于Java代码实现的例子：

import org.flywaydb.core.Flyway;

public class DatabaseMigration {
    public static void main(String[] args){
        Flyway flyway = new Flyway();
        flyway.setDataSource("jdbc:mysql://localhost:3306/mydb", "root", "");
        flyway.migrate(); // 开始执行所有待处理的任务
    }
}

一旦启动应用程序之后，Flyway便会依据之前提到的那个历史日志表去判断哪些更新尚未被执行过，从而依次应用它们直至最新版为止[^3]。

如果遇到诸如校验和不一致等问题，则可能是因为修改后的脚本破坏了原有的哈希值计算结果所致。此时可以考虑清理缓存重新生成新的校验码或者干脆删除旧有的记录让系统重头再来一次完整的同步动作[^2]。