容器化测试是什么
Testcontainers 让集成测试按需拉起一次性 Docker 容器作为真实依赖（数据库、消息队列、浏览器），用例结束自动销毁。测试环境从共享的固定实例变成每条用例自带，隔离性与可复现性同时改善；Java、Python、Node、Go、.NET 都有对应绑定。
基本信息
| 前置条件 | 本机或 CI 运行器具备 Docker（可访问 docker socket） |
|---|---|
| 多语言绑定 | Java testcontainers、Python testcontainers-python、Node testcontainers-node 等 |
| 生命周期 | 容器按需启动，with 块或测试进程结束即销毁 |
| 兜底清理 | Ryuk 边车容器回收未被正常清理的容器与卷 |
| 常用模块 | PostgreSQL、MySQL、Redis、Kafka、Selenium、GenericContainer（任意镜像） |
| 就绪策略 | 端口监听、日志关键字、健康检查命令等等待条件 |
最小示例
最小示例
from testcontainers.postgres import PostgresContainer
# 启动一次性 PostgreSQL 容器（固定版本号，保证可复现）
with PostgresContainer("postgres:16", dbname="app") as pg:
url = pg.get_connection_url() # 拿到直连串，供被测代码使用
run_migrations(url) # 建表与灌入最小数据
assert query(url, "select 1") == 1
# 退出 with 块后：容器停止，数据卷被清理典型使用场景
- 验证真实数据库方言：SQL 语法、事务隔离、索引行为都按真库跑
- 中间件行为测试：消息队列的重投、延迟、死信语义用真实组件验证
- 替换共享测试环境：每个分支或开发者互不污染，告别抢库造数据
- 本地一键跑集成测试：装好 Docker 即可，无需手工搭环境
- 锁定版本组合：镜像 tag 固定到具体小版本，复现线上同款依赖
- UI 测试基础设施：用容器提供浏览器或被测应用的自包含环境
常见模块与用途
| 模块 | 起什么 | 典型用途 |
|---|---|---|
| PostgresContainer | PostgreSQL 实例 | 方言与事务行为验证 |
| MySQLContainer | MySQL 实例 | 字符集、隔离级别差异测试 |
| RedisContainer | Redis 实例 | 缓存语义与过期行为 |
| KafkaContainer | Kafka 单节点 | 消息顺序与重投测试 |
| GenericContainer | 任意镜像 | 自研服务、代理、混沌场景 |
镜像 tag 不要用 latest：小版本漂移会让昨天绿的测试今天变红，锁定到具体版本并定期有计划地升级。
容器启动有秒级成本：能用会话级复用就不要每条用例起停；复用时用独立 schema 或库名隔离数据。
等待就绪用内置策略（端口、日志、健康检查），不要用固定 sleep 猜时间——慢机器上猜短了会随机失败。