在Testcontainers中数据库CHECK约束未生效的问题排查

问题场景 #

在Spring Boot集成测试中，使用Testcontainers提供PostgreSQL实例，通过Liquibase创建了带有CHECK约束的calendar表，约束规则为is_weekend与is_pre_holiday不能同时为true。但测试时保存违反该约束的实体，未触发预期的数据库约束异常，测试错误通过。

核心原因 #

1. 事务未触发实际数据库写入：@DataJpaTest默认给测试方法开启事务，且测试结束后自动回滚。repository.save()仅将实体放入Hibernate持久化上下文，并未立即执行SQL写入数据库，导致数据库的CHECK约束未被触发校验。
2. Testcontainers容器配置冲突：同时使用Testcontainers JDBC URL自动创建容器，又手动定义了未启用的PostgreSQLContainer实例，造成容器管理冗余（虽非约束失效直接原因，但会引发不必要的资源浪费）。

解决方案 #

方案1：强制触发数据库写入校验约束 #

修改测试方法，保存实体后调用flush()强制Hibernate将SQL发送到数据库，同时断言预期异常：

@DataJpaTest
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
@ActiveProfiles("integration-test")
public class CalendarRepositoryTest {

    @Autowired
    CalendarRepository calendarRepository;

    @Test
    void dateCanNotBeWeekendAndPreHolidayTest() {
        CalendarEntity calendarEntity = new CalendarEntity(LocalDate.of(2000, 1, 1), true, true);

        // 断言会抛出数据完整性异常（对应数据库CHECK约束违反）
        assertThrows(DataIntegrityViolationException.class, () -> {
            calendarRepository.save(calendarEntity);
            calendarRepository.flush(); // 强制刷新到数据库，触发约束校验
        });
    }
}

方案2：关闭测试方法事务 #

通过@Transactional(propagation = Propagation.NOT_SUPPORTED)关闭当前测试方法的事务，直接执行数据库写入：

@Test
@Transactional(propagation = Propagation.NOT_SUPPORTED)
void dateCanNotBeWeekendAndPreHolidayTest() {
    CalendarEntity calendarEntity = new CalendarEntity(LocalDate.of(2000, 1, 1), true, true);

    assertThrows(DataIntegrityViolationException.class, () -> {
        calendarRepository.saveAndFlush(calendarEntity);
    });
}

方案3：修正Testcontainers容器配置（可选） #

选择一种容器管理方式，避免重复定义：

• 方式A：保留JDBC URL自动创建容器：删除手动定义的PostgreSQLContainer静态实例，Testcontainers会通过jdbc:tc:postgresql://localhost/testDB自动创建并管理容器。
• 方式B：手动管理容器：保留PostgreSQLContainer实例，添加@Container注解，并修改数据源配置：

@Container
static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:14")
        .withUsername("user")
        .withPassword("password")
        .withDatabaseName("test_db");

修改application-integration-test.yaml的数据源URL：

spring:
  datasource:
    url: jdbc:postgresql://${postgres.host}:${postgres.port}/test_db
    username: user
    password: password

补充说明 #

• Hibernate的ddl-auto: validate仅校验实体映射与数据库Schema的一致性，不会提前校验数据库层面的CHECK约束，约束校验必须通过实际的数据库写入操作触发。
• 预期的数据库异常中文描述：错误：关系"calendar"的新行违反检查约束"calendar_check"

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