数据库版本管理工具flyway的使用心得

今天测试了一下flyway的功能，在使用过程中遇到几个问题消耗了我一上午时间，网上也没有找到相应的解决方案，自己摸索了一上午，终于搞定了。

我的项目是使用maven构建的web项目，依赖代码：

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

 在spring中添加如下配置：

    <bean id="flyway" class="org.flywaydb.core.Flyway" init-method="migrate">  
	    <property name="dataSource" ref="dataSource"/>
	</bean> 

 数据库的dataSource请根据实际情况自己配置。

 

在项目的resources/db/migration下创建sql文件V1.0.0__20151125.sql文件，再次启动后正常。

 

这时如果再新建一个sql文件，如V1.0.1__20151126.sql，故意把sql语句写错，比如写错表名，再启动时，会发现启动报错，提示表名错误。 如果把这个 sql修改正确后，再次重启，会发现以下错误：

 

com.googlecode.flyway.core.migration.MigrationException: Migration to version 1.0.1 failed! Please restore backups and roll back database and code!
at com.googlecode.flyway.core.migration.DbMigrator.migrate(DbMigrator.java:158)

出现这个问题我当时就蒙了，不知道如何解决，无论怎么重启都是这个错误，网上也没有最终的解决办法，最终我看了一下源码，发现有repair方法，于是把applicationContext.xml中flyway配置修改，把migrate修改为repair，再次启动，启动成功，再刷新schema_version表，发现出错的那条记录已被删除；再把配置文件中的repair还原为migrate后启动，这次启动成功了，并且V1.0.1中的语句已执行完成。

回到源码看Repair的注释，意思大致是：

Repairs the Flyway metadata table. This will perform the following actions:
Remove any failed migrations on databases without DDL transactions (User objects left behind must still be cleaned up manually)
Correct wrong checksums

 修改flyway的元数据表，即修改schema_version表中的数据，这个操作会做以下操作：

1、删除所有失败的非事务性数据库ddl操作；(用户对象如表、视图等需要手工清除)

2、修正错误的sql文件校验码（当文件修改过后，生成的校验码会改变）。

 

如果后期在生产环境部署时遇到同样的错误，可以考虑使用命令行的形式调用repair来修复版本数据。