本文详解如何解决 Spring Boot 集成 Testcontainers 与 Liquibase 时，因测试容器初始化顺序不当引发的重复数据插入问题，核心在于正确配置 jdbc:tc: 协议驱动，确保 Liquibase 仅在 Testcontainer 启动后的纯净数据库上执行一次变更集。
本文详解如何解决 spring boot 集成 testcontainers 与 liquibase 时，因测试容器初始化顺序不当引发的重复数据插入问题，核心在于正确配置 `jdbc:tc:` 协议驱动，确保 liquibase 仅在 testcontainer 启动后的纯净数据库上执行一次变更集。
在基于 Spring Boot + Testcontainers + Liquibase 的集成测试中，你可能会遇到一个典型却隐蔽的问题：Liquibase 在测试上下文加载阶段反复执行插入类变更集（如 insert_test_user.yaml），导致违反唯一约束（如 user_email_key）而启动失败。根本原因并非 Liquibase 配置错误或 SQL 逻辑缺陷，而是 Spring Boot 的 DataSource 初始化时机早于 Testcontainer 容器就绪 —— 当你使用硬编码的本地 PostgreSQL 连接（如 jdbc:postgresql://localhost:5432/postgres）时，Spring 会尝试连接一个尚未被 Testcontainer 启动/接管的“空”或“残留”数据库；此时 Liquibase 可能读取到旧数据、或在多次测试运行间复用未清理的容器实例，最终触发重复 INSERT 异常。
✅ 正确解法：强制 Liquibase 通过 Testcontainer JDBC 驱动初始化
关键在于让 Spring 的 DataSource 和 Liquibase 完全绑定到 Testcontainer 生命周期。需在 src/test/resources/application-test.properties 中替换原有数据源配置：
# ❌ 错误：直连本地 PostgreSQL，绕过 Testcontainer 管理 # spring.datasource.url=jdbc:postgresql://localhost:5432/postgres # spring.datasource.driver-class-name=org.postgresql.Driver # ✅ 正确：使用 Testcontainer 提供的透明代理协议 spring.datasource.driver-class-name=org.testcontainers.jdbc.ContainerDatabaseDriver spring.datasource.url=jdbc:tc:postgresql://localhost:5432/test
?
jdbc:tc:协议是 Testcontainer 的核心机制：它会在首次连接时自动拉起并配置 PostgreSQL 容器，并确保每次测试运行都获得全新、隔离、空的数据库实例。Liquibase 将在此干净环境中执行全部变更集（建表 + 插入），避免历史数据干扰。
? 补充最佳实践
-
禁用 Liquibase 自动执行（可选但推荐）
若你仅需建表结构（而非预置测试数据），可在测试配置中关闭插入类变更集：# 仅执行 schema 变更，跳过 data/inserts/ spring.liquibase.change-log=classpath:db/changelog/db.changelog-master.yaml # 并在 master.yaml 中注释掉 includeAll: db/changelog/inserts/
-
确保测试容器生命周期可控
你的@Container声明已正确使用@Shared（Spock 推荐），但需确认PostgreSQLContainer实例未被其他测试类意外复用。建议为每个测试类声明独立容器，或显式清理：@Override def cleanup() { userRepository.deleteAll() // 清理测试数据，非必需但增强隔离性 } -
验证 Liquibase 执行日志
启动测试时观察控制台输出，确认 Liquibase 日志中出现类似：INFO liquibase.executor.jvm.JdbcExecutor - SELECT COUNT(*) FROM public.databasechangeloglock INFO liquibase.lockservice.StandardLockService - Successfully acquired change log lock INFO liquibase.changelog.ChangeSet - Table users created INFO liquibase.changelog.ChangeSet - Inserted test user: john@example.com
这表明 Liquibase 已在 Testcontainer 数据库中成功且仅执行一次迁移。
⚠️ 注意事项
- 不要混合使用
jdbc:postgresql://和jdbc:tc://—— 二者指向不同数据库实例，极易引发状态不一致。 - 若使用自定义
DatabaseContainer子类（如带初始化脚本的容器），仍需保持jdbc:tc:协议，Testcontainer 会自动注入。 - Spock 的
@Shared容器默认在类级别复用，若多个测试类共享同一容器，务必确保其变更集幂等（如使用<pre class="brush:php;toolbar:false;" conditions></pre>检查表是否存在）。
通过上述配置，你的 UserControllerITest 将稳定启动：Liquibase 在纯净容器中完成一次性建表与初始化，后续测试操作（如 restTemplate.postForEntity()）将真实触发业务层唯一性校验逻辑，返回预期的 400 BAD_REQUEST，而非因环境问题中断测试流程。
