sbt配置Flyway插件执行flywayMigrate命令提示无效的问题咨询

核心原因 #

你将所有Flyway相关的任务与配置都绑定到了自定义的custom配置域下，没有在全局默认配置中注册Flyway任务，因此直接执行sbt flywayMigrate会提示找不到对应命令。

排查步骤 #

• 首先检查plugins.sbt的插件引入是否正确，正确引入格式如下（注意替换为和你sbt版本兼容的Flyway插件版本）：

addSbtPlugin("org.flywaydb" % "flyway-sbt" % "对应版本号")

• 执行sbt tasks命令查看当前项目已注册的任务列表，确认是否存在带custom前缀的Flyway相关任务，比如custom:flywayMigrate。

解决方法 #

方案1：保留自定义配置域，调整执行命令 #

不需要修改现有配置，执行命令时加上自定义配置域的前缀即可：

sbt custom:flywayMigrate

其余Flyway相关命令同理，比如查看迁移状态用custom:flywayInfo、清理数据库用custom:flywayClean。

方案2：取消自定义配置域绑定，使用默认命令 #

如果不需要单独的自定义配置域，修改build.sbt配置，将Flyway配置直接注册到全局项目设置中：

lazy val flyWay = (project in file("."))
  .settings(
    FlywayPlugin.flywayBaseSettings(Runtime) ++ Seq(
      flywayUser := "andrej",
      flywayPassword := "123456",
      flywayUrl := "jdbc:postgresql://localhost:5432/database",
      flywayLocations += "db/migration"
    ): _*
  )

修改后直接执行sbt flywayMigrate即可正常运行。

额外校验项 #

• 确认项目依赖中已经引入PostgreSQL驱动，可在build.sbt中添加对应依赖：

libraryDependencies += "org.postgresql" % "postgresql" % "42.5.4" // 可替换为对应版本

• 确认resources/db/migration下的SQL文件命名符合Flyway规范：必须以V开头，后跟版本号、双下划线、迁移描述，比如V1__init_user_table.sql。

内容的提问来源于stack exchange，提问作者Jelly