SpringBoot+TestContainers+Liquibase环境下级联删除失败求助

TestContainers本身无需额外配置即可支持PostgreSQL的级联删除，问题核心大概率出在Liquibase变更集的执行有效性或外键约束的实际生效状态上，以下是具体排查和解决步骤：

1. 确认Liquibase变更集已在测试环境执行 #

检查TestContainers启动日志，确认包含addForeignKeyConstraint的变更集是否成功执行。若测试环境未触发Liquibase迁移，数据库中的外键约束不会携带ON DELETE CASCADE属性，自然会触发约束错误。

可通过以下方式确保迁移执行：

• 测试类需添加@SpringBootTest，依赖Spring Boot自动配置Liquibase（默认加载db/changelog下的变更集）。
• 若使用自定义测试配置，确认未排除LiquibaseAutoConfiguration。

2. 验证数据库中外键的实际配置 #

临时在测试代码中添加查询逻辑，连接TestContainers的PostgreSQL，检查目标外键的属性：

SELECT 
    tc.constraint_name, 
    tc.table_name, 
    kcu.column_name, 
    ccu.table_name AS referenced_table_name, 
    ccu.column_name AS referenced_column_name,
    rc.delete_rule
FROM 
    information_schema.table_constraints AS tc
JOIN 
    information_schema.key_column_usage AS kcu
  ON tc.constraint_name = kcu.constraint_name
JOIN 
    information_schema.constraint_column_usage AS ccu
  ON ccu.constraint_name = tc.constraint_name
JOIN
    information_schema.referential_constraints AS rc
  ON tc.constraint_name = rc.constraint_name
WHERE 
    tc.constraint_type = 'FOREIGN KEY' AND
    tc.constraint_name = 'fk30d6gcohuxxjs6f3cqwtbtu69';

若查询结果中delete_rule不为CASCADE，说明Liquibase变更集未正确应用到测试数据库。

3. 检查Liquibase变更集的正确性 #

• 核对变更集的constraintName与错误信息中的约束名fk30d6gcohuxxjs6f3cqwtbtu69是否一致，若不一致，说明你配置的是其他外键，报错的约束未配置级联删除。
• 检查字段映射：baseColumnNames应为table2中关联table1的字段（当前配置为table2_id，疑似笔误，应为table1_id？），字段名错误会导致变更集创建无效外键，或未覆盖报错的约束。

4. 排查测试数据初始化逻辑 #

若测试数据通过data.sql或JPA实体初始化，需确认：

• 插入table2数据时，关联的table1记录已存在。
• 初始化数据的事务已提交，避免外键关联未持久化。

5. 版本兼容性检查 #

Liquibase 3.7.0为2019年发布的旧版本，与Spring Boot 2.7.3、TestContainers 1.17.3可能存在兼容性问题。建议升级Liquibase至Spring Boot 2.7.x推荐的兼容版本（如4.15.x系列），避免版本差异导致变更集执行异常。

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