Spring Boot进阶(52)：Spring Boot 如何集成Flyway并初始化执行 SQL 脚本？| 超级详细，建议收藏

1. 前言

       在我们的认知中，我们会使用 SVN 或 Git 进行代码的版本管理。但是，我们是否好奇过，数据库也是需要进行版本管理的呢？

        在每次发版的时候，我们可能都会对数据库的表结构进行新增和变更，又或者需要插入一些初始化的数据。而我们的环境不仅仅只有一套，一般来说项目会有 dev、test、pred、prod四套环境，会对应 dev、test、prod 三个数据库。pred 环境，一般连接 prod 数据库，做准生产的验收。

        那么，就意味着我们需要对 dev、test、prodD 数据库都做一遍初始化操作。“人，是系统最大的 BUG”。很多时候，我们并不能保证像机器一样，每次都操作都正确，这就导致在不同的环境下，因为数据的每个版本的初始化，带来额外的验收成本。

        甚至说，因为我们常常是手动操作 dev 数据库，没有整理一个完整清单，保证我们在 test、prod 数据库中执行相同的操作。

        基于以上种种，如果我们能像管理代码版本一样，来管理我们的数据库版本，是不是这些问题可以得到很好的解决？答案是，绝大多数是的。

目前，技术社区已经提供了很多解决方案。比如：

• Flyway

• Liquibase

• dbdeploy

• SQL Source Control

• dbv

• MyBatis Migrations

        在 Spring Boot 项目中，提供了对 Flyway 和 Liquibase 的内置支持，所以在有数据库版本的需求时，肯定是推荐它两。

        本文，我会对 Flyway 进行深入入门学习。这样，我们在学习它的同时，可以有比较直观的使用感受，方便后续我们对它们进行选型。

        那么，具体如何集成Flyway 呢？这将又会是干货满满的一期，全程无尿点不废话只抓重点教，具有非常好的学习效果，拿好小板凳准备就坐！希望学习的过程中大家认真听好好学，学习的途中有任何不清楚或疑问的地方皆可评论区留言或私信，bug菌将第一时间给予解惑，那么废话不多说，直接开整！Fighting！！ 

2. 环境说明

本地的开发环境：

• 开发工具：IDEA 2021.3
• JDK版本： JDK 1.8
• Spring Boot版本：2.3.1 RELEASE
• Maven版本：3.8.2

3. Flyway 

3.1 概念

        Flyway 是一款开源的数据库版本管理工具。它可以很方便的在命令行中使用，或者在Java应用程序中引入，用于管理我们的数据库版本。

　　在项目或产品中，很难一开始就把业务理清楚，把数据库表设计好，因此数据表也会在迭代周期不断迭代。在Java应用程序中使用Flyway，能快速有效地用于迭代数据库表结构，并保证部署到测试环境或生产环境时，数据表都是保持一致的。

具体介绍请看Flyway官方文档

3.2 依赖包

        如果你是使用的maven构建工具，那你直接将如下依赖添加到你项目的pom.xml中即可

    org.flywaydb
    flyway-core

3.3 使用flyway好处

        在多人开发的项目中，我们都习惯了使用SVN或者Git来对代码进行版本控制，主要的目的就是为了解决多人开发代码冲突和版本回退的问题。其实，数据库的变更也需要做版本控制，在日常开发中，我们经常会遇到下面的问题，比如：

1. 自己写的SQL忘了在所有环境中执行初始化；别人写的SQL我们不能确定是否都在所有环境执行过了。
2. 有人修改了已经执行过的SQL，期望再次执行。
3. 需要新增环境做数据迁移。
4. 每次发版需要手动控制先发DB版本，再发布应用版本。
5. 其它场景。

        有了flyway，这些问题都能得到很好的解决。

4. 集成Flyway

        接下来，我就带着大家实战如何集成Flyway，具有很好的教学意义，同学们认真听好好学。

4.1 引入依赖包

首先需要在 pom.xml 文件中添加相应的依赖，示例代码如下：

    org.flywaydb
    flyway-core

4.2 配置sql脚本

        然后在 application.yaml 或 application.properties 文件中配置数据库信息，并指定 SQL 脚本的位置，示例代码如下：

spring:
  flyway:
    enabled: true # 开启 Flyway 功能
    cleanDisabled: true # 禁用 Flyway 所有的 drop 相关的逻辑，避免出现跑路的情况。
    locations: # 迁移脚本目录
      classpath: db/migration # 配置 SQL-based 的 SQL 脚本在该目录下
    check-location: false # 是否校验迁移脚本目录下。如果配置为 true ，代表需要校验。此时，如果目录下没有迁移脚本，会抛出 IllegalStateException 异常
    url: jdbc:mysql://localhost:3306/springboot_db?serverTimezone=GMT%2B8&useUnicode=true&characterEncoding=utf-8 # 数据库地址
    user: root # 数据库账号
    password: 123456 # 数据库密码

注意：spring.flyway 配置项，设置 Flyway 的属性，而后可以被 FlywayAutoConfiguration 自动化配置。 每个配置项的作用，自己看下注释。 重点看下 locations 配置项，该配置设置了 SQL 迁移脚本所在目录。

4.3 定义SQL脚本

        在 resources/db/migration 目录下，创建 V1.0__INIT_DB.sql  SQL迁移脚本。具体项目位置截图如下演示：

 sql脚本代码如下：

DROP TABLE IF EXISTS `cat`;
CREATE TABLE `cat`  (
                         `id` bigint(20) NOT NULL AUTO_INCREMENT,
                         `color` varchar(64) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
                         `name` varchar(64) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
                         `age` int(11) NULL DEFAULT NULL,
                         PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 3 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;

INSERT INTO `cat` VALUES (4, 'red', '波斯猫', 30);
INSERT INTO `cat` VALUES (5, 'blue', '蓝猫', 50);
INSERT INTO `cat` VALUES (6, 'green', '蓝白', 80);

4.4 sql 脚本命名规范

        对于 V1.0__INIT_DB.sql 的命名上。Flyway 是有明确规定的，约定如下：

Prefix 前缀：V 为版本迁移，U 为回滚迁移，R 为可重复迁移。

在我们的示例中，我们使用 V 前缀，表示版本迁移。绝大多数情况下，我们只会使用 V 前缀。

Version 版本号：每一个迁移脚本，都需要一个对应一个唯一的版本号。而脚本的执行顺序，按照版本号的顺序。一般情况下，我们使用数字自增即可。

在我们的示例中，我们使用 1.0 。

Separator 分隔符：两个 _ ，即 __ 。可配置，不过一般不配置。

Description 描述：描述脚本的用途。

在我们的示例中，我们使用 INIT_DB 。

Suffix 后缀：.sql 。可配置，不过一般不配置。

标准命令举例：V1.0__INIT_DB.sql、V3.0__INIT_DB.sql.等

4.5 启动项目测试

        基本配置已具备，接下来就是验证成功的关键了，我们重启项目查验FlyWay是否生效。

启动项目，执行日志如下所示：

        如果看到打印了以上日志，说明脚本执行成功了。查验下cat表也可以看到数据有被成功插入。

        从启动日志中可以看出，Flyway 监测到需要运行版本脚本来初始化数据库，因此执行了V1.0__INIT_DB.sql 脚本，从而创建了 cat 表，另外还自动创建了 

flyway_schema_history 表，用于记录所有版本演化和状态，其表结构如下(以 MySQL 为例)：

        查询 flyway_schema_history 表，发现增加了一条版本号为 1.0 的，使用 V1.0__INIT_DB.sql 迁移脚本的记录。

        再次重启项目，可以看到，提示打印：Schema springboot_db is up to date. No migration necessary.意味着springboot_db是最新的，无需版本迁移。

        接下来，我们在 V1.0__INIT_DB.sql 迁移脚本中添加一条 INSERT 操作：INSERT INTO `cat` VALUES (7, 'pink', '粉色猫', 90);，再次启动项目，控制台会报如下错误：

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'flywayInitializer' defined in class path resource [org/springframework/boot/autoconfigure/flyway/FlywayAutoConfiguration$FlywayConfiguration.class]: Invocation of init method failed; nested exception is org.flywaydb.core.api.FlywayException: Validate failed: 
Migration checksum mismatch for migration version 2.0
-> Applied to database : -719082334
-> Resolved locally    : 1598008518

完整报错截图如下： 

        这个错误的原因就是 Flyway 会给脚本计算一个 checksum 保存在数据库中，用于在之后运行过程中对比 sql 文件是否有变化，如果发生了变化，则会报错，也就防止了误修改脚本导致发生问题。

        注意：只有在第一次启动时会执行脚本，之后相同的脚本不会再次执行，可以通过flyway的插件主动执行一次SQL脚本；也可以通过删除数据库中的flyway_schema_history表或者表中的相应脚本执行成功的记录让项目下次启动时会再次执行一次脚本。

4.6 演示修改脚本执行 

        接下来，我们来演示一下:删除掉V2.0__INIT_DB执行成功的记录，然后在迁移脚本中再添加一条 INSERT 操作，我们重启项目查验下结果：

结果如下：很明显脚本执行成功了。

对应flyway_schema_history表中也记录生成了一条记录。

4.7 总结

• Flyway 可以有效改善数据库版本管理方式，并且是一款 Java 开源的数据库迁移管理工具，具有轻便小巧的特点，可以无门槛快速集成到项目中。
• 对于我们的Flyway要根据我们的实际情况进行我们的库表删除,不要忙目删除我们的flyway_schema_history表。

        总之，Flyway 是一款 Java 开源的数据库迁移管理工具，轻便小巧，想了解更多的可以去官网查看文档学习，这里就不一一赘述啦。

5. 热文推荐

滴~如下推荐【Spring Boot 进阶篇】的学习大纲，请小伙伴们注意查收。

Spring Boot进阶(01)：Spring Boot 集成 Redis，实现缓存自由

Spring Boot进阶(02)：使用Validation进行参数校验

Spring Boot进阶(03)：如何使用MyBatis-Plus实现字段的自动填充

Spring Boot进阶(04)：如何使用MyBatis-Plus快速实现自定义sql分页

Spring Boot进阶(05)：Spring Boot 整合RabbitMq，实现消息队列服务

Spring Boot进阶(06)：Windows10系统搭建 RabbitMq Server 服务端

Spring Boot进阶(07)：集成EasyPoi，实现Excel/Word的导入导出

Spring Boot进阶(08)：集成EasyPoi，实现Excel/Word携带图片导出

Spring Boot进阶(09)：集成EasyPoi，实现Excel文件多sheet导入导出

Spring Boot进阶(10)：集成EasyPoi，实现Excel模板导出成PDF文件

Spring Boot进阶(11)：Spring Boot 如何实现纯文本转成.csv格式文件？

Spring Boot进阶(12)：Spring Boot 如何获取Excel sheet页的数量？

Spring Boot进阶(13)：Spring Boot 如何获取@ApiModelProperty(value = “序列号“, name = “uuid“)中的value值name值？

Spring Boot进阶(14)：Spring Boot 如何手动连接库并获取指定表结构？一文教会你

Spring Boot进阶(15)：根据数据库连接信息指定分页查询表结构信息

Spring Boot进阶(16)：Spring Boot 如何通过Redis实现手机号验证码功能？

Spring Boot进阶(17)：Spring Boot如何在swagger2中配置header请求头等参数信息

Spring Boot进阶(18)：SpringBoot如何使用@Scheduled创建定时任务？

Spring Boot进阶(19)：Spring Boot 整合ElasticSearch

Spring Boot进阶(20)：配置Jetty容器

Spring Boot进阶(21)：配置Undertow容器

Spring Boot进阶(22)：Tomcat与Undertow容器性能对比分析

Spring Boot进阶(23)：实现文件上传

Spring Boot进阶(24)：如何快速实现多文件上传？

Spring Boot进阶(25)：文件上传的单元测试怎么写?

Spring Boot进阶(26)：Mybatis 中 resultType、resultMap详解及实战教学

Spring Boot进阶(27)：Spring Boot 整合 kafka(环境搭建+演示)

Spring Boot进阶(28)：Jar包Linux后台启动部署及滚动日志查看，日志输出至实体文件保存

Spring Boot进阶(29)：如何正确使用@PathVariable，@RequestParam、@RequestBody等注解？不会我教你，结合Postman演示

Spring Boot进阶(30)：@RestController和@Controller 注解使用区别，实战演示

...

6. 文末

        如果想系统性的学习Spring Boot，小伙伴们直接订阅bug菌专门为大家创建的Spring Boot专栏《滚雪球学Spring Boot》从入门到精通，从无到有，从零到一！以知识点+实例+项目的学习模式由浅入深对Spring Boot框架进行学习&使用。

       我是bug菌，一名想走出大山改变命运的程序猿。接下来的路还很长，都等待着我们去突破、去挑战。来吧，小伙伴们，我们一起加油！未来皆可期，fighting！

​

关注公众号，获取最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板等硬核资源