Spring Boot 学习笔记 10 : Flyway 异常

最近使用 SpringBoot 集成 Mybatis 开发项目，关于数据库表结构的生成决定采用 Flyway 或者 Liquibase 这样的数据库版本工具，或者叫数据库迁移工具。在使用 Flyway 的过程中，遇到一些问题先记录下来。

---

在 application.properties 文件中配置 Flyway

## 是否启用flyway
flyway.enabled=true
## 编码格式，默认UTF-8
flyway.encoding=UTF-8
## 迁移sql脚本文件存放路径，默认db/migration
flyway.locations=db/migration
## 迁移sql脚本文件名称的前缀，默认V
flyway.sql-migration-prefix=V
## 迁移sql脚本文件名称的分隔符，默认2个下划线__
flyway.sql-migration-separator=__
## 迁移sql脚本文件名称的后缀
flyway.sql-migration-suffix=.sql
## 迁移时是否进行校验，默认true
flyway.validate-on-migrate=true
## 将schema_version表从数据库删除后抛出异常
## Caused by: org.flywaydb.core.api.FlywayException:
## Found non-empty schema(s) `nmg-crm` without metadata table!
## Use baseline() or set baselineOnMigrate to true to initialize the metadata table.
## 设置为true，当迁移发现数据库非空且存在没有元数据的表时，自动执行基准迁移，新建schema_version表
flyway.baseline-on-migrate=true

---

Unable to resolve location classpath:db/migration 警告

使用默认配置，Flyway 会自动去寻找 db/migration 目录下的迁移脚本文件，如果你使用的是 IDEA 开发工具，需要注意的是 db 目录下的 migration 目录中的脚本文件，而不是名称为 db.migration 的目录中的脚本文件。

错误示例：

正确示例：

---

org.flywaydb.core.api.FlywayException: Validate failed: Detected failed migration to version 2 (mysql-schema) 异常

在执行 V2__mysql-schema.sql 脚本时由于建表没有设置主键自增，插入数据抛出异常导致 Flyway 迁移失败。

当我再次运行程序时抛出异常：

这时候删除 schema_version 表即可。

---

org.flywaydb.core.api.FlywayException: Validate failed: Detected applied migration not resolved locally: 2 异常

出现异常的原因是我在 V2__mysql-schema.sql 脚本文件未作任何内容修改的情况下将脚本文件名称更改为 V2.1__mysql-schema.sql 。