Flyway无法执行数据库迁移，请求技术排查

1. 基础配置校验 #

• Maven依赖兼容性：如果是Spring Boot项目，优先使用spring-boot-starter-flyway而非单独引入flyway-core，避免版本冲突。正确依赖示例：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-flyway</artifactId>
  </dependency>
  

• application.properties关键配置检查：
  • 确认spring.flyway.enabled=true（默认开启，但可能被误配置为false）
  • 若迁移文件放在resources/migrations，需显式指定路径：spring.flyway.locations=classpath:migrations（默认路径是classpath:db/migration）
  • 核对数据库连接参数spring.datasource.url、spring.datasource.username、spring.datasource.password，确保Flyway能正常连接目标库
  • 若数据库已有业务表但未初始化Flyway元数据，需设置spring.flyway.baseline-on-migrate=true触发自动基线化

2. 迁移文件合法性检查 #

• 命名规则：严格遵循V<版本号>__<描述>.sql格式，注意版本与描述间是两个下划线，你的V1_1__CREATE_TABLES.sql命名合规，但要保证文件名无拼写错误（Linux/macOS环境区分大小写）
• 文件位置：确认V1_1__CREATE_TABLES.sql确实在src/main/resources/migrations下，打包后可检查target/classes/migrations目录是否存在该文件
• SQL语法验证：直接在数据库客户端执行该SQL文件，排查是否存在语法错误（如关键字冲突、字段名拼写错误），Flyway遇到语法错误会终止迁移，部分场景下错误日志不明显

3. 日志定位问题 #

• 开启Flyway debug日志，在application.properties中添加：

  logging.level.org.flywaydb=DEBUG
  

  启动应用后重点查看：
  • Flyway是否完成初始化，是否加载到目标迁移文件
  • 是否存在数据库连接失败、SQL执行报错、元数据表权限不足等错误信息
  • 若日志显示"Schema is up to date"，需检查flyway_schema_history表是否已有该迁移记录，若存在但未生效，可能是之前执行失败后被错误标记为成功

4. 元数据表排查 #

• 连接目标数据库，查看flyway_schema_history表（默认表名）：
  • 表不存在：说明Flyway未成功连接数据库或被禁用
  • 表存在但无version=1.1的记录：Flyway未识别到迁移文件，需回到配置/文件位置排查
  • 存在version=1.1但状态为FAILED：删除该记录或修复SQL后重新执行迁移

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