Spring Boot升级至2.7.7时Liquibase H2集成测试遇重复文件错误

问题根源 #

错误提示的两个重复文件分别来自target/classes（主编译资源）和target/test-classes（测试编译资源），说明主源码与测试源码目录下存在路径完全一致的SQL文件。spring.liquibase.duplicateFileMode=WARN未生效，大概率是因为Spring Boot 2.7.x中该配置的生效逻辑或键名格式发生了变化，而非配置本身无效。

解决方法 #

1. 分离主/测试SQL文件路径 #

最直接的方式是给测试专用SQL文件单独设置路径，避免与主资源路径冲突：

• 主资源SQL：src/main/resources/config/liquibase/sqlFiles/
• 测试资源SQL：src/test/resources/config/liquibase/test-sqlFiles/
  然后在测试环境配置（如application-test.yml）中指定测试专属的Liquibase changelog：

spring:
  liquibase:
    change-log: classpath:/config/liquibase/test-changelog.xml

确保测试用的changelog仅引用test-sqlFiles下的文件。

2. 修正Maven资源复制配置 #

检查pom.xml中maven-resources-plugin的配置，确保测试资源不会被错误复制到target/classes目录：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-resources-plugin</artifactId>
      <version>3.3.1</version>
      <executions>
        <execution>
          <id>copy-main-resources</id>
          <phase>process-resources</phase>
          <goals><goal>copy-resources</goal></goals>
          <configuration>
            <outputDirectory>${project.build.outputDirectory}</outputDirectory>
            <resources>
              <resource>
                <directory>src/main/resources</directory>
              </resource>
            </resources>
          </configuration>
        </execution>
        <execution>
          <id>copy-test-resources</id>
          <phase>process-test-resources</phase>
          <goals><goal>copy-resources</goal></goals>
          <configuration>
            <outputDirectory>${project.build.testOutputDirectory}</outputDirectory>
            <resources>
              <resource>
                <directory>src/test/resources</directory>
              </resource>
            </resources>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

3. 正确配置重复文件处理模式 #

Spring Boot 2.7.x中，spring.liquibase.duplicate-file-mode需要使用短横线分隔的键名（而非驼峰式duplicateFileMode），且建议通过测试类直接注入配置确保生效：

@TestPropertySource(properties = "spring.liquibase.duplicate-file-mode=WARN")
public class YourIntegrationTest {
    // 测试代码
}

4. 给SQL文件添加环境前缀并过滤 #

如果必须保留相同路径，可给测试SQL文件添加test-前缀，然后在changelog中通过过滤规则加载对应环境的文件：

• 主changelog.xml：

<includeAll path="config/liquibase/sqlFiles/" relativeToChangelogFile="true" filter="^((?!test-).)*$"/>

• 测试changelog.xml：

<includeAll path="config/liquibase/sqlFiles/" relativeToChangelogFile="true" filter="test-.*\.sql"/>

验证步骤 #

1. 执行mvn clean test，彻底清理target目录后重新运行测试
2. 检查target/classes和target/test-classes下的SQL文件是否仍存在重复
3. 确认Liquibase的配置参数已正确加载

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