修改application.properties后Flyway出现循环依赖Bean错误排查

问题概述 #

• 项目原本使用YAML格式配置文件（应为application.yml），改为键值对格式application.properties后，执行mvn install触发Flyway与entityManagerFactory循环依赖错误
• 此前YAML配置阶段存在数据库无法写入数据的问题，两者存在关联

解决方案 #

一、修复Flyway与EntityManagerFactory循环依赖 #

Spring Boot中Flyway默认会在EntityManagerFactory初始化前执行，但自定义配置易触发循环依赖，可通过以下方式解决：

1. 强制Flyway在EntityManagerFactory之后初始化

创建配置类显式控制Bean顺序：

@Configuration
public class FlywayConfig {
    @Bean
    @DependsOn("entityManagerFactory")
    public Flyway flyway(DataSource dataSource) {
        Flyway flyway = Flyway.configure()
                .dataSource(dataSource)
                .locations("classpath:db/migration")
                .load();
        flyway.migrate();
        return flyway;
    }
}

2. 禁用自动配置，手动管理Flyway

在application.properties中关闭自动配置：

spring.flyway.enabled=false

再用上述配置类手动初始化Flyway，确保依赖关系正确。

3. 让EntityManagerFactory依赖Flyway（若需先执行迁移）

如果要求Flyway先完成数据库迁移，可在JPA配置类上添加依赖：

@Configuration
@DependsOn("flyway")
@EnableJpaRepositories(basePackages = "com.yourpackage.repository")
@EntityScan(basePackages = "com.yourpackage.entity")
public class JpaConfig {
    // 自定义EntityManagerFactory相关配置
}

二、解决配置文件导致的数据库写入失败 #

1. 检查配置格式正确性

• YAML格式必须用空格缩进（禁止Tab），键值对冒号后需加空格：

  spring:
    datasource:
      url: jdbc:mysql://localhost:3306/your_db
      username: root
      password: 123456
      driver-class-name: com.mysql.cj.jdbc.Driver
    jpa:
      hibernate:
        ddl-auto: update
  

• 键值对格式的application.properties需用点分隔层级：

  spring.datasource.url=jdbc:mysql://localhost:3306/your_db
  spring.datasource.username=root
  spring.datasource.password=123456
  spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
  spring.jpa.hibernate.ddl-auto=update
  

2. 验证数据库连接有效性

• 确认数据库服务正常运行，端口、账号密码无误
• 检查是否配置了正确的数据库驱动（如MySQL 8+需用com.mysql.cj.jdbc.Driver）

3. 检查事务配置

确保业务写入方法上添加了@Transactional注解，Spring Boot默认已启用事务管理，若自定义配置需确保事务生效。

验证流程 #

1. 先修复Flyway循环依赖，执行mvn clean install确认构建通过
2. 启动项目，调用写入接口验证数据是否正常入库
3. 若仍有问题，查看日志中的数据库连接、事务异常信息，定位具体报错点

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