使用Testcontainers进行Java集成测试

2025/12/2 1:14:51 来源：https://blog.csdn.net/weixin_53840353/article/details/139916646 浏览: 次关键词：使用Testcontainers进行Java集成测试

在现代软件开发中，集成测试是确保应用程序与其依赖项（如数据库、消息队列等）正确交互的关键步骤。Testcontainers是一个支持JUnit测试的Java库，它提供了一个简单而强大的方式来创建和管理测试所需的任何Docker容器。本文将详细介绍如何使用Testcontainers进行集成测试，并提供丰富的代码示例。

1. 引入Testcontainers依赖

首先，你需要在你的项目中添加Testcontainers依赖。如果你使用Maven，可以在pom.xml中添加以下依赖：

<dependencies><dependency><groupId>org.testcontainers</groupId><artifactId>testcontainers</artifactId><version>1.17.3</version> <!-- 使用最新版本 --><scope>test</scope></dependency><dependency><groupId>org.testcontainers</groupId><artifactId>postgresql</artifactId><version>1.17.3</version> <!-- 使用最新版本 --><scope>test</scope></dependency>
</dependencies>

2. 创建PostgreSQL容器

接下来，我们将创建一个PostgreSQL容器的实例，并在测试中使用它。以下是一个简单的JUnit测试类示例：

import org.junit.jupiter.api.Test;
import org.testcontainers.containers.PostgreSQLContainer;
import org.testcontainers.junit.jupiter.Container;
import org.testcontainers.junit.jupiter.Testcontainers;@Testcontainers
public class PostgreSQLTest {@Containerprivate static PostgreSQLContainer<?> postgreSQLContainer = new PostgreSQLContainer<>("postgres:13.3").withDatabaseName("integration-tests-db").withUsername("test").withPassword("test");@Testpublic void testPostgreSQLContainer() {// 这里可以编写使用数据库的测试代码System.out.println("PostgreSQL container is running: " + postgreSQLContainer.isRunning());}
}

在这个例子中，我们创建了一个PostgreSQL容器，并设置了数据库名、用户名和密码。@Container注解使得容器在测试类中的所有测试方法运行之前启动，并在所有测试完成后停止。

3. 编写集成测试

现在，我们可以编写一个实际的集成测试，使用这个PostgreSQL容器。假设我们有一个简单的服务，它使用JDBC连接到数据库并执行一些操作。

import org.junit.jupiter.api.Test;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.Statement;public class UserServiceTest {@Testpublic void testUserService() throws Exception {try (Connection connection = DriverManager.getConnection(postgreSQLContainer.getJdbcUrl(),postgreSQLContainer.getUsername(),postgreSQLContainer.getPassword())) {Statement statement = connection.createStatement();statement.executeUpdate("CREATE TABLE users (id serial PRIMARY KEY, name VARCHAR(100))");statement.executeUpdate("INSERT INTO users (name) VALUES ('John Doe')");// 执行查询或其他操作}}
}

在这个测试中，我们连接到由Testcontainers管理的PostgreSQL容器，并执行了一些SQL操作。这确保了我们的服务能够正确地与数据库交互。