Spring Boot集成测试前自定义SQL脚本未执行问题排查及解决方案

首先咱们先拆解可能导致custom_script.sql没执行的原因，再给你几个针对性的解决方案：

常见原因排查 #

• 配置类未被正确加载：如果你的测试配置只是个接口，可能没加@TestConfiguration或@Configuration注解，或者测试类没通过@Import、@ComponentScan把它纳入Spring上下文。
• 脚本路径错误：Spring Boot默认从classpath加载资源，但你的脚本在test模块同级目录，用classpath:custom_script.sql肯定找不到，得用文件系统路径file:../custom_script.sql。
• 数据源不匹配：检查测试用的数据源URL，是不是脚本执行到了内存数据库（比如H2）而不是你预期的数据库？看测试日志里的数据源配置就能确认。
• 未绑定测试生命周期：就算配置了脚本执行逻辑，没绑定到测试的BEFORE_TEST阶段，也不会自动触发。

最优解决方案 #

方案1：用@Sql注解快速实现（适合单测试类/方法场景） #

直接在测试类或方法上添加@Sql注解，指定脚本路径和执行时机，简单粗暴：

@SpringBootTest
// 测试方法执行前执行脚本，路径指向同级目录的custom_script.sql
@Sql(scripts = "file:../custom_script.sql", executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
public class YourBusinessTest {
    // 你的测试方法
}

如果不确定路径，可以先写绝对路径测试，再改成相对路径；要是所有测试都需要执行，把注解加到测试基类上就行。

方案2：自定义TestExecutionListener（适合全局测试场景） #

如果所有测试类都需要执行这个触发器脚本，自定义监听器绑定到测试生命周期更高效：

public class TriggerScriptListener extends AbstractTestExecutionListener {

    @Autowired
    private DataSource dataSource;

    @Override
    public void beforeTestClass(TestContext testContext) throws Exception {
        super.beforeTestClass(testContext);
        // 从测试上下文注入Spring容器
        testContext.getApplicationContext().getAutowireCapableBeanFactory().autowireBean(this);
        // 执行脚本
        try (Connection conn = dataSource.getConnection()) {
            ScriptUtils.executeSqlScript(conn, new FileSystemResource("../custom_script.sql"));
        }
    }
}

然后在测试类（或基类）上注册监听器，注意要合并默认监听器，不然会丢失Spring Boot自带的测试功能：

@SpringBootTest
@TestExecutionListeners(
        listeners = TriggerScriptListener.class,
        mergeMode = TestExecutionListeners.MergeMode.MERGE_WITH_DEFAULTS
)
public class YourBaseTest {
    // ...
}

方案3：用Flyway/Liquibase管理数据库脚本（推荐生产级方案） #

如果你的项目需要长期维护数据库对象（触发器、存储过程、表结构），用数据库迁移工具是最规范的做法，以Flyway为例：

1. 添加依赖（Maven）：

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
    <scope>test</scope>
</dependency>

2. 规范脚本命名：把custom_script.sql重命名为V1__create_triggers.sql（Flyway命名规则：V<版本号>__<描述>.sql），放到test/resources/db/migration目录，或者直接配置Flyway读取同级目录的脚本。
3. 配置Flyway（在application-test.yml中）：

spring:
  flyway:
    # 同时加载classpath内的迁移脚本和同级目录的脚本
    locations: classpath:db/migration,filesystem:../db_scripts
    # 首次执行时自动基线化，避免历史脚本冲突
    baseline-on-migrate: true

这样Spring Boot启动测试时，Flyway会自动执行所有未执行过的迁移脚本，还会记录执行状态，防止重复执行，非常适合团队协作和长期维护。

最后排查小技巧 #

打开测试日志（调整日志级别为DEBUG），搜索SqlScript或Flyway相关日志，就能看到脚本是否被加载、执行时有没有报错，快速定位问题。

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