SpringBoot中集成Flyway实现数据库sql版本管理入门以及遇到的那些坑

ゝ一纸荒年。 2023-10-13 14:51 3阅读 0赞

## 场景 ##

Git/ SVN 是代码界的版本控制工具，那么，Flyway 就是一款数据库界的版本控制工具，

它可以记录数据库的变化记录。可能很多公司都是通过人工去维护、同步数据库脚本，

但经常会遇到疏忽而遗漏的情况，举个简单的例子：

我们在开发环境对某个表新增了一个字段，而提交测试时却忘了提交该 SQL 脚本，导致出现 bug 而测试中断，

从而影响开发、测试的工作效率。有了 Flyway，我们可以按版本约定，统一管理所有的 SQL 脚本变更，

在所有环境自动同步数据库，而无需人为手工控制，再也不用担心因数据库不同步而导致的各种环境问题。

官网：[Homepage - Flyway][]

下面记录在SpringBoot项目中集成Flyway的过程。

注：

博客：  
[霸道流氓气质的博客\_CSDN博客-C\#,架构之路,SpringBoot领域博主][CSDN_-C_SpringBoot]

## 实现 ##

1、首先搭建SpringBoot项目并配置连接Mysql的依赖和配置文件，然后pom文件中添加flyway的依赖

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

只需添加以上依赖即可，这里示例的完整依赖为

<dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
            <dependency>
                <groupId>com.mysql</groupId>
                <artifactId>mysql-connector-j</artifactId>
                <scope>runtime</scope>
            </dependency>
            <dependency>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <optional>true</optional>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <scope>test</scope>
            </dependency>
            
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
            </dependency>
            
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter</artifactId>
                <version>2.2.1</version>
            </dependency>
            
            <dependency>
                <groupId>org.flywaydb</groupId>
                <artifactId>flyway-core</artifactId>
                <version>7.10.0</version>
            </dependency>
        </dependencies>

2、然后在yml中添加flyway的相关配置

放在spring节点下

![d9561bd607af41e0a6cea13c2562f1c3.png][]

配置的内容为

flyway:
        #是否启用
        enabled: true
        # 可以支持多个location, 用','隔开
        locations: classpath:db/migration
        # 是否允许无序的迁移，默认false
        out-of-order: false
        # 是否创建元数据表
        validate-on-migrate: true
        # flyway 的 clean 命令会删除指定 schema 下的所有 table, 生产务必禁掉。这个默认值是false 理论上作为默认配置是不科学的
        clean-disabled: true
        # 如果数据库不是空表，需要设置成 true，否则启动报错
        baseline-on-migrate: true
        # 版本控制日志表，默认flyway_schema_history,不同系统建议修改数据
        # table: flyway_schema_history

3、上面配置的locations即为sql文件的存放位置，这里也是默认位置，可自由配置。

这里的脚本sql的命名规则是

V + 版本号(版本号的数字间以”.“或”\_“分隔开) + 双下划线(用来分隔版本号和描述) + 文件描述 + 后缀名

注意这里的双下划线来分割版本号和文件描述。

示例：

V20230710\_1\_\_init.sql

比如这里初始化数据库的sql这样命名，代表执行初始化数据的操作，比如建表或插入基础数据等。

可以在Navicat等客户端软件中直接将基础库导出为sql并重命名。

将上面的sql放到resource目录下新建的db目录下的migration目录下

![ba2cfde8385b455c9e939d0441e0785e.png][]

4、先执行初始化基础库的sql，这里启动项目如果没有报错并能看到以下执行成功的提示

![c51ad58c41e24727918a7af321992c6a.png][]

此时查看数据库，会新建表flyway\_schema\_history表，这是版本记录表。

并且验证init的sql文件已经执行成功。

假如我们要修改其中某个表，比如给user表添加一个字段。

首先通过Navicat等软件修改本地表添加字段

![2bf89453905042f0b0ea462542aef1c1.png][]

在Navicat中修改表字段可以直接在SQL预览中看到执行操作的sql。

比如这里新增address字段的SQL预览为

ALTER TABLE `test`.`user`
        ADD COLUMN `address` varchar(255) NULL AFTER `pass`;

再新建V20230710\_2\_\_add\_address\_to\_user.sql文件，将上面的sql内容复制进来。

此时代表版本2的更改。

重启项目，查看日志，当前版本执行到2

![49fbe00602e74d1ba7e5db3e5dfc8423.png][]

并且历史记录包中记录也新增

![e6f5962aa31847bc95e88845475175dd.png][]

本地将address字段删除后，重启项目后会发现会执行版本2的添加字段的操作。

5、遇到的坑

SpringBoot中集成Flyway启动时提示：

Flyway failed to initialize: none of the following migration scripts locations could be found:

![914fb3f88b144032a3e0748dfca5dc23.png][]

仔细核对配置与目录均正确。

报错是因为在IDEA新建目录时直接使用db.migration创建，会被认定为一个目录，

应该在resource下先新建db再在db下新建migration目录。

另外要注意如果发现目录下的sql没有执行，一定要注意sql文件的命名格式，尤其是使用双下划线来区分版本号和描述。

[Homepage - Flyway]: https://flywaydb.org/
[CSDN_-C_SpringBoot]: https://blog.csdn.net/badao_liumang_qizhi
[d9561bd607af41e0a6cea13c2562f1c3.png]: https://img-blog.csdnimg.cn/d9561bd607af41e0a6cea13c2562f1c3.png
[ba2cfde8385b455c9e939d0441e0785e.png]: https://img-blog.csdnimg.cn/ba2cfde8385b455c9e939d0441e0785e.png
[c51ad58c41e24727918a7af321992c6a.png]: https://img-blog.csdnimg.cn/c51ad58c41e24727918a7af321992c6a.png
[2bf89453905042f0b0ea462542aef1c1.png]: https://img-blog.csdnimg.cn/2bf89453905042f0b0ea462542aef1c1.png
[49fbe00602e74d1ba7e5db3e5dfc8423.png]: https://img-blog.csdnimg.cn/49fbe00602e74d1ba7e5db3e5dfc8423.png
[e6f5962aa31847bc95e88845475175dd.png]: https://img-blog.csdnimg.cn/e6f5962aa31847bc95e88845475175dd.png
[914fb3f88b144032a3e0748dfca5dc23.png]: https://img-blog.csdnimg.cn/914fb3f88b144032a3e0748dfca5dc23.png