本文介绍一种简洁可靠的方案，让多个测试类共享同一套数据库初始化 SQL 脚本——通过继承带 @Sql 的基类实现跨测试类的预置数据，避免重复配置且确保执行时机（测试前）严格可控。
本文介绍一种简洁可靠的方案，让多个测试类共享同一套数据库初始化 sql 脙本——通过继承带 `@sql` 的基类实现跨测试类的预置数据，避免重复配置且确保执行时机（测试前）严格可控。
在 Spring Boot 测试中，@Sql 注解虽常用于单个测试类或方法级别，但若需在多个测试类间复用同一组初始化 SQL（如插入基础用户、配置项等），直接在每个类上重复声明既冗余又易出错。官方不支持在 @Configuration 类中直接使用 @Sql（因其设计为测试生命周期注解，仅对测试类/方法生效），但可通过面向对象继承机制优雅解决该需求。
✅ 推荐方案：基于基类的统一 SQL 初始化
定义一个抽象或具体的基础测试类，添加 @Sql 并指定脚本执行策略：
@DataJpaTest
@Sql(
scripts = "classpath:/sql/init-test-data.sql", // 推荐：外部化 SQL 到文件更清晰
executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD
)
public class DatabaseTestBase {
// 可在此处定义通用的 TestEntityManager、JdbcTemplate 等依赖
}
? 提示：优先使用 scripts = "classpath:/sql/init-test-data.sql" 而非内联 statements，便于 SQL 维护、复用与版本控制；SQL 文件路径需确保位于 src/test/resources 下。
随后各业务测试类只需继承该基类即可自动获得数据初始化能力：
class CustomerServiceTests extends DatabaseTestBase {
@Autowired
private CustomerRepository repository;
@Test
void shouldFindInitializedCustomer() {
assertThat(repository.findByName("John")).isPresent();
}
}
class OrderServiceTests extends DatabaseTestBase {
@Test
void shouldProcessOrderWithPreloadedCustomers() {
// 自动拥有 CUSTOMER 表中的初始数据
}
}
⚠️ 注意事项与最佳实践
- 执行顺序保障：@Sql 默认在每个测试方法执行前运行（BEFORE_TEST_METHOD），若需全局一次性初始化（如建表后只插一次），可配合 @SqlGroup + executionPhase = BEFORE_CLASS，但需注意事务隔离限制（推荐保持默认每方法前执行，兼容 @Transactional 测试）。
- 事务管理：@DataJpaTest 默认启用事务回滚，因此每次测试后的数据变更会被自动清理，无需手动清理 SQL。
- 避免循环依赖：勿将 @Sql 基类标记为 @Configuration 或 @Component——它仅作为测试基础设施存在，不应被 Spring 容器管理。
- 进阶替代方案（谨慎使用）：若必须“零继承”（如已有父类），可借助 @TestInstance(Lifecycle.PER_CLASS) + @BeforeAll 配合 JdbcTemplate 手动执行 SQL，但会失去 @Sql 的脚本解析、错误定位和事务集成优势。
综上，继承式基类是 Spring 测试生态中最轻量、最稳定、最符合约定的跨测试共享 SQL 初始化方案——简洁、显式、可测试、无侵入性。
