Testcontainers Java: 用 Docker 容器跑集成测试

做 Java 开发的人大概都遇到过这个问题：写集成测试需要真实数据库，但本地装一个 MySQL、PostgreSQL 太重了，CI 环境里配环境更麻烦。Testcontainers 就是专门解决这个的，它是一个 Java 库，能在测试里快速启动 Docker 容器，用完自动销毁。

它能干什么

简单说，就是在 JUnit 测试里声明需要什么容器，Testcontainers 帮你拉镜像、启容器、连服务，测试结束后自动清理。支持的东西覆盖面很广：

• 常见数据库：MySQL、PostgreSQL、MongoDB、Redis、Neo4j
• 消息队列：Kafka、RabbitMQ
• 浏览器：通过 Selenium 启动 Chrome、Firefox
• 几乎任何有 Docker 镜像的服务都能跑

用法不复杂，加个 Maven 或 Gradle 依赖，写几行配置，容器就起来了。比如要测 PostgreSQL，代码大概长这样：声明一个 PostgreSQLContainer 对象，指定版本号，测试方法里直接拿 JDBC 连接串用就行。

为什么不用 H2 之类的内存数据库

很多人的做法是测试时用 H2 模拟数据库行为。问题是 H2 和真实数据库的差异不小，字段类型、SQL 方言、事务隔离级别都可能不同。测试过了但生产环境挂了，这种事不少见。Testcontainers 跑的就是真实数据库实例，测试结果和生产环境一致，这类问题直接消失。

适合什么场景

团队已经有 Docker 环境的，接入成本最低。CI/CD 流水线里用效果最好，每个测试任务起独立容器，互不干扰。本地开发也行，但需要本机装 Docker。

对微服务架构的项目特别合适。每个服务依赖不同的中间件，用 Testcontainers 可以在测试里把这些依赖全部容器化，不用每个人都本地装一套开发环境。新同事入职，跑一次测试脚本，所有依赖自动拉起来。

需要考虑的地方

Docker 环境是硬依赖，没装 Docker 就没法用。容器冷启动需要时间，如果测试用例特别多，启动开销要算进总耗时里。另外，Testcontainers 默认会从 Docker Hub 拉镜像，网络不好的环境下首次跑会慢一些，可以配置镜像加速或者预拉取。

项目目前 Star 8600 多，在 Java 测试工具里算是主流选择，社区活跃，模块覆盖也比较全。如果团队在做 Java 项目的持续集成，Testcontainers 基本属于标配工具了，比起自己在 CI 脚本里写容器编排逻辑，用这个库省事很多。

配工具了，比起自己在 CI 脚本里写容器编排逻辑，用这个库省事很多。