Flyway + Spring Boot：实现数据库迁移的最佳实践

Flyway 和 Spring Boot 整合的最佳实践

数据库迁移工具 Flyway 是许多开发者在使用 Spring Boot 时的首选配置之一。在复杂的企业应用中，数据库需要随功能演进不断迭代，如果没有一个良好的迁移工具来管理，容易导致后期混乱和不可预期的问题。

本文，我们将探讨如何结合 Flyway 和 Spring Boot，实现不同数据库的支持和最佳实践。无论是 MySQL、PostgreSQL 还是 Oracle，本指南都可助你轻松管理你的数据库脚本。

---

一、Flyway 简介

Flyway 是一个开源数据库迁移工具，主要功能包括：

• 管理和跟踪数据库变化。
• 使用简单的 SQL 文件记录各次数据库更新。
• 提供很好的版本控制机制和回滚能力。

二、整合 Flyway 和 Spring Boot

在 Spring Boot 中集成 Flyway 只需要简单的几步：

1. 引入依赖

在 pom.xml 中增加 Flyway 的依赖：

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
</dependency>

2. 创建迁移脚本

Flyway 通过固定格式的脚本文件来管理迁移。存储脚本的默认路径是：src/main/resources/db/migration。

文件命名规则：V<版本号>__<描述>.sql 示例：

V1__Init_schema.sql
V2__Add_new_column.sql

3. 配置 application.properties

Flyway 的配置信息可以在 Spring Boot 的配置文件中完成：

spring.flyway.url=jdbc:mysql://localhost:3306/yourdb
spring.flyway.user=root
spring.flyway.password=password
spring.flyway.locations=classpath:db/migration
spring.flyway.baseline-on-migrate=true

4. 启动迁移

启动应用程序时，Spring Boot 会自动运行 Flyway 脚本。

---

三、支持多种数据库的配置

开发中，常遇到需要支撑不同类型数据库的场景。例如开发环境使用 MySQL，而测试/生产环境可能是 PostgreSQL。

1. 根据环境区分配置

利用 Spring 的 Profile 功能，我们可以为不同环境配置不同的数据库连接。

application-dev.properties（MySQL）：

spring.flyway.url=jdbc:mysql://localhost:3306/devdb
spring.flyway.user=dev_user
spring.flyway.password=dev_password

application-prod.properties（PostgreSQL）：

spring.flyway.url=jdbc:postgresql://prod-db-url:5432/proddb
spring.flyway.user=prod_user
spring.flyway.password=prod_password

2. 自定义脚本路径

对于不同的数据库，SQL 语法可能会略有不同。这时可以通过 Flyway 的 locations 参数指定不同路径。

配置文件示例：

spring.flyway.locations=classpath:db/migration/mysql,classpath:db/migration/postgresql

在上述示例中，脚本会存放在 mysql 或 postgresql 子目录中，分别支持不同的数据库。

---

四、最佳实践

1. 增加"基线"

图省事删除旧数据表时，可能会遇到 Flyway 错误。这可以通过 baseline-on-migrate 配置解决，告诉 Flyway 从某一版本开始迁移。

spring.flyway.baseline-on-migrate=true
spring.flyway.baseline-version=1

2. 明确脚本顺序

迁移脚本按照版本升序执行。一定要保证文件命名符合规则，否则会报错。

3. 定期清理过期脚本

随着项目发展，迁移脚本会越来越多。建议定期合并脚本，比如把过时的脚本整合到一起。可以使用 Flyway Pro 版提供的 clean 功能。

4. 避免破坏性操作

尽量不要在迁移脚本中使用 DROP 或 DELETE 操作，这可能影响生产环境数据。

---

五、结语

结合 Flyway 和 Spring Boot 是现代软件开发中管理数据库变更的最佳方式之一。通过本文掌握的基本实践和配置技巧，你应该能上手用 Flyway 管理数据库了。希望能够帮助到大家！