如何在JUnit+Spring Boot+TestContainers集成测试中避免数据冲突？

问题背景 #

使用Spring Boot+JUnit+TestContainers（Docker、MySQL 8.0.29）开发集成测试时，单独执行每个测试均通过，但批量执行（如CI/CD环境）时失败。核心原因是测试无序执行，导致查询数据的测试运行前，目标数据已被其他测试删除。尝试过两种方案但未生效：

1. 尝试为实体设置唯一ID，但Hibernate已配置自动生成ID：

@Entity
public class Assignment {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Integer id;
}

2. 在每个测试前删除表数据，但未生效：

@Autowired
private JdbcTemplate jdbcTemplate;

@BeforeEach
void tearDown() {
    JdbcTestUtils.deleteFromTables(jdbcTemplate, "assignment");
}

示例集成测试代码：

@Test
void When_getById_Verify_Fields() {
    AssignmentDTO assignmentDTO = new AssignmentDTO();
    assignmentDTO.setTitle("test");
    assignmentDTO.setDescription("test");
    assignmentDTO.setUserId("1");
    assignmentDTO.setCreator("1");

    assignmentService.addAssignment(assignmentDTO);

    AssignmentDTO expectedAssignment = assignmentService.getById(1);

    assertEquals(assignmentDTO.getTitle(), expectedAssignment.getTitle());
    assertEquals(assignmentDTO.getDescription(), expectedAssignment.getDescription());
    assertEquals(assignmentDTO.getUserId(), expectedAssignment.getUserId());
    assertEquals(assignmentDTO.getCreator(), expectedAssignment.getCreator());
}

解决思路与可行方案 #

1. 确保测试数据完全隔离 #

• 使用事务回滚：给每个测试方法添加@Transactional注解，Spring Boot默认会在测试结束后自动回滚事务，测试数据不会写入数据库，自然不会污染其他测试。注意不要在测试类或方法上添加@Commit注解。
• 替换删除为截断表：JdbcTestUtils.deleteFromTables仅删除数据，但MySQL的自增ID不会重置，后续插入的ID会持续累加，导致硬编码ID查询失效。改成截断表并重置自增序列：

@BeforeEach
void tearDown() {
    jdbcTemplate.execute("TRUNCATE TABLE assignment");
}

或者保留删除逻辑，手动重置自增：

@BeforeEach
void tearDown() {
    JdbcTestUtils.deleteFromTables(jdbcTemplate, "assignment");
    jdbcTemplate.execute("ALTER TABLE assignment AUTO_INCREMENT = 1");
}

2. 避免硬编码ID查询 #

示例测试中直接用getById(1)依赖自增ID从1开始，批量测试时自增ID会因之前的测试累加，导致查询失败。改为插入后获取真实ID：

@Test
void When_getById_Verify_Fields() {
    AssignmentDTO assignmentDTO = new AssignmentDTO();
    assignmentDTO.setTitle("test");
    assignmentDTO.setDescription("test");
    assignmentDTO.setUserId("1");
    assignmentDTO.setCreator("1");

    // 调整addAssignment方法，返回插入后的ID
    Integer savedId = assignmentService.addAssignment(assignmentDTO);

    AssignmentDTO expectedAssignment = assignmentService.getById(savedId);

    assertEquals(assignmentDTO.getTitle(), expectedAssignment.getTitle());
    assertEquals(assignmentDTO.getDescription(), expectedAssignment.getDescription());
    assertEquals(assignmentDTO.getUserId(), expectedAssignment.getUserId());
    assertEquals(assignmentDTO.getCreator(), expectedAssignment.getCreator());
}

如果无法修改addAssignment返回ID，可通过其他唯一条件（如标题+用户ID）查询数据后再验证。

3. 强制测试顺序（应急方案，不推荐） #

如果暂时无法重构测试逻辑，可通过JUnit指定测试顺序，但这违反测试独立性原则，仅作为临时解决办法：

@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
public class AssignmentTests {
    @Test
    @Order(1)
    void testAddAssignment() {
        // 新增数据的测试
    }

    @Test
    @Order(2)
    void When_getById_Verify_Fields() {
        // 查询数据的测试
    }
}

4. 检查TestContainers容器生命周期 #

确保每个测试类使用独立的数据库容器，或者在测试类之间重置容器。使用@Container注解时，Spring Boot TestContainers会自动管理容器，默认每个测试类启动新容器；若使用@TestInstance(TestInstance.Lifecycle.PER_CLASS)，需手动在测试类结束后重置容器状态。

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