10.1What Testcontainers Solves

Integration tests have a dependency problem. Your code talks to PostgreSQL, Kafka, Redis, and Elasticsearch -- but where do those services come from in your test environment? The old answers were painful: shared test databases that accumulate stale data, Docker Compose files that fall out of sync, or mocking everything and hoping the mocks match reality.

Testcontainers solves this by spinning up real instances of infrastructure dependencies in Docker, managed by your test code. Each test gets fresh, isolated instances that are destroyed when the test finishes. No shared state, no cleanup scripts, no "it works on my machine."