如何高效隔离Spring+Testcontainers的CRUD集成测试？

我遇到了集成测试互相影响的问题：比如删除客户测试会修改数据库数据，导致后续的客户列表查询测试结果不符合预期。目前试过两种方案但都有问题：

• 类级别加@DirtiesContext：能重置应用上下文，但测试执行成本太高，每次都要重启上下文，速度慢。
• Spring的@Transactional注解：本来应该自动回滚测试数据，但在Testcontainers环境下完全无效。

找不到官方文档里的对应方案，请问怎么解决这个问题？

相关代码 #

删除客户测试代码 #

class DeleteCustomerIntegrationTest extends AbstractConfigurationTest {

   @Test
   void deleteCustomer_shouldReturnStatusNoContent() throws Exception {
      mockMvc.perform(delete("/api/v1/customer/1")).andExpect(status().isNoContent());
   }
}

客户列表查询测试代码 #

class CustomerListIntegrationTest extends AbstractConfigurationTest {

  @Test
  void listCustomers_shouldMatchExpectedResponseObject() throws Exception {
    String expectedJson = """ [object goes here] """;

    mockMvc.perform(get("/api/v1/customers").contentType(MediaType.APPLICATION_JSON))
        .andExpect(status().isOk())
        .andExpect(content().json(expectedJson));
  }
}

测试配置类代码 #

@AutoConfigureMockMvc
@SpringBootTest
public class AbstractConfigurationTest {

  @Autowired
  protected MockMvc mockMvc;

  private static final PostgreSQLContainer<?> POSTGRESQL_CONTAINER;
  private static final Logger LOGGER = LoggerFactory.getLogger(AbstractConfigurationTest.class);

  static {
    POSTGRESQL_CONTAINER =
        new PostgreSQLContainer<>("postgres:15-alpine")
            .withDatabaseName("customers")
            .withUsername("customers")
            .withPassword("customers")
            .withCopyFileToContainer(MountableFile.forClasspathResource("01_init.sql"), "/docker-entrypoint-initdb.d/01_init.sql")
            .withCopyFileToContainer(MountableFile.forClasspathResource("02_data.sql"), "/docker-entrypoint-initdb.d/02_data.sql")
            .withLogConsumer(new Slf4jLogConsumer(LOGGER));

    POSTGRESQL_CONTAINER.start();
  }

  @DynamicPropertySource
  static void dynamicProperties(DynamicPropertyRegistry registry) {
    registry.add("spring.datasource.url", POSTGRESQL_CONTAINER::getJdbcUrl);
    registry.add("spring.datasource.username", POSTGRESQL_CONTAINER::getUsername);
    registry.add("spring.datasource.password", POSTGRESQL_CONTAINER::getPassword);
    registry.add("spring.datasource.driver-class-name", POSTGRESQL_CONTAINER::getDriverClassName);
  }
}

可行解决方案 #

方案1：手动重置测试数据（轻量高效） #

在父类的@BeforeEach方法里重新执行数据初始化脚本，把数据库恢复到初始状态。这种方式比重启上下文快很多，只操作数据库。

修改AbstractConfigurationTest，添加数据重置逻辑：

@Autowired
private JdbcTemplate jdbcTemplate;

@BeforeEach
void resetTestData() {
    // 先清空表（有外键的话用CASCADE自动处理关联数据）
    jdbcTemplate.execute("TRUNCATE TABLE customers CASCADE;");
    // 重新执行初始化数据的SQL脚本
    Resource dataScript = new ClassPathResource("02_data.sql");
    try {
        String sqlContent = FileCopyUtils.copyToString(new InputStreamReader(dataScript.getInputStream()));
        jdbcTemplate.execute(sqlContent);
    } catch (IOException e) {
        throw new RuntimeException("重置测试数据失败", e);
    }
}

方案2：使用Testcontainers独立容器隔离数据 #

把静态容器改成@Container注解，让每个测试类启动独立的PostgreSQL容器，彻底隔离测试数据。缺点是测试总时间会增加，但数据完全不会互相影响。

修改AbstractConfigurationTest的容器配置：

@AutoConfigureMockMvc
@SpringBootTest
public class AbstractConfigurationTest {

  @Autowired
  protected MockMvc mockMvc;

  @Container // 每个测试类会创建独立容器实例
  private final PostgreSQLContainer<?> postgreSQLContainer =
      new PostgreSQLContainer<>("postgres:15-alpine")
          .withDatabaseName("customers")
          .withUsername("customers")
          .withPassword("customers")
          .withCopyFileToContainer(MountableFile.forClasspathResource("01_init.sql"), "/docker-entrypoint-initdb.d/01_init.sql")
          .withCopyFileToContainer(MountableFile.forClasspathResource("02_data.sql"), "/docker-entrypoint-initdb.d/02_data.sql")
          .withLogConsumer(new Slf4jLogConsumer(LOGGER));

  private static final Logger LOGGER = LoggerFactory.getLogger(AbstractConfigurationTest.class);

  @DynamicPropertySource
  static void dynamicProperties(DynamicPropertyRegistry registry, PostgreSQLContainer<?> container) {
    registry.add("spring.datasource.url", container::getJdbcUrl);
    registry.add("spring.datasource.username", container::getUsername);
    registry.add("spring.datasource.password", container::getPassword);
    registry.add("spring.datasource.driver-class-name", container::getDriverClassName);
  }
}

方案3：修复@Transactional失效问题 #

@Transactional在Testcontainers中失效通常是配置问题，按以下步骤排查修复：

1. 给测试类加上@Transactional和@Rollback注解，确保测试方法在事务内执行，结束后自动回滚：

@Transactional
@Rollback
class DeleteCustomerIntegrationTest extends AbstractConfigurationTest {

   @Test
   void deleteCustomer_shouldReturnStatusNoContent() throws Exception {
      mockMvc.perform(delete("/api/v1/customer/1")).andExpect(status().isNoContent());
   }
}

2. 检查项目是否开启了事务管理：确保主配置类加了@EnableTransactionManagement注解
3. 确认事务管理器正确绑定了Testcontainers的数据源：Spring Boot默认会自动配置，如果自定义了数据源，需要手动指定事务管理器的数据源

内容的提问来源于stack exchange，提问作者vrz-dev