Spring Boot集成测试前执行SQL脚本无效问题排查

1. 确认SQL脚本路径与资源目录配置 #

• 先检查src/integrationTest/resources是否被构建工具识别为测试资源目录。Maven项目需在pom.xml中添加配置，确保该目录下的资源能被加载：

<build>
  <testResources>
    <testResource>
      <directory>src/test/resources</directory>
    </testResource>
    <testResource>
      <directory>src/integrationTest/resources</directory>
    </testResource>
  </testResources>
</build>

• 尝试在@Sql注解中明确指定类路径前缀：@Sql(scripts = "classpath:clean-up.sql", executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)，避免路径识别偏差。

2. 验证SQL脚本内容有效性 #

• 直接在PostgreSQL客户端执行clean-up.sql中的语句，确认是否能正常删除目标数据：
  • 检查表名、字段名是否匹配，PostgreSQL对大小写敏感，若表名含大写需用双引号包裹（如DELETE FROM "User"）
  • 排查脚本是否存在未提交的事务，必要时在脚本末尾添加COMMIT;强制提交
• 确认脚本无语法错误，比如是否漏写WHERE条件导致未命中数据

3. 检查Cucumber与Spring Test的集成有效性 #

• 确保测试类已正确集成Spring Boot，让@Sql注解能被Spring Test处理：

@CucumberContextConfiguration
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class CucumberSpringConfig {
}

• 给StepDefinitions类添加@Component或@StepDefinitions注解，确保它被Spring容器管理，否则@Sql注解不会生效

4. 排查事务冲突问题 #

• 如果测试方法标注了@Transactional，@Sql执行的删除操作可能会被后续事务回滚。可尝试：
  • 将executionPhase改为Sql.ExecutionPhase.BEFORE_TEST_CLASS
  • 移除测试方法的@Transactional注解，再验证数据是否被删除

5. 启用日志定位问题 #

• 在application-integrationTest.yml中开启日志，查看SQL脚本执行细节：

logging:
  level:
    org.springframework.test.context.jdbc: DEBUG
    org.springframework.jdbc: DEBUG

• 通过日志确认脚本是否被加载、执行时是否有报错（如表不存在、权限不足等）

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