如何通过Spring Profiles配置Flyway迁移文件位置并解决版本冲突

这个问题我之前也碰到过，核心原因是单元测试的ClassPath默认会同时包含main/resources和test/resources两个目录。当你用dev Profile跑测试时，Flyway会按照配置的spring.flyway.locations=classpath:db/migration/{vendor}去扫描所有ClassPath下匹配的路径，结果同时找到了两个目录下的同版本迁移文件，直接触发了版本冲突的错误。

下面给你几个可行的解决方案，按推荐程度排序：

方案1：调整迁移文件目录结构（最推荐） #

把不同环境的迁移文件完全隔离到各自的专属目录，从根源上避免ClassPath扫描交叉：

• 将dev环境的迁移文件放到main/resources/db/migration/dev/h2
• 将test环境的迁移文件放到main/resources/db/migration/test/postgresql

然后修改对应的Profile配置：

• application-dev.properties：

  spring.flyway.locations=classpath:db/migration/dev/{vendor}
  

• application-test.properties：

  spring.flyway.locations=classpath:db/migration/test/{vendor}
  

这样不管是运行应用还是执行单元测试，Flyway只会加载对应Profile指定目录下的迁移文件，彻底杜绝交叉扫描的问题，也符合Spring Boot资源管理的规范。

方案2：在单元测试中显式指定Flyway路径 #

如果你暂时不想调整文件结构，可以在dev环境的单元测试类上，通过@TestPropertySource覆盖Flyway的location配置，强制只加载test/resources下的迁移文件：

@SpringBootTest
@ActiveProfiles("dev")
@TestPropertySource(properties = {
    "spring.flyway.locations=classpath:/db/migration/h2"
})
public class DevEnvUnitTest {
    // 你的测试代码
}

这种方式适合快速临时解决问题，但长期维护下来，不如方案1的目录结构清晰直观。

方案3：通过构建工具排除不必要的资源（不推荐） #

可以在Maven/Gradle的构建配置中，指定执行dev Profile测试时排除main/resources中的迁移文件。比如Maven的配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <configuration>
                <activeProfiles>dev</activeProfiles>
                <resources>
                    <resource>
                        <directory>src/main/resources</directory>
                        <excludes>
                            <exclude>db/migration/**</exclude>
                        </excludes>
                    </resource>
                </resources>
            </configuration>
        </plugin>
    </plugins>
</build>

这种方式属于“hack式”解决，会增加构建配置的复杂度，不利于后续维护，仅作为备选方案。

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