Java 后端 / 系统课时
编写端到端集成测试
编写端到端集成测试
本课用一个订单链路示例,把 HTTP 请求、数据库写入和 Kafka 异步消费放进同一个 @SpringBootTest 中验证。完成后,你将拥有一条可重复执行、能发现跨组件集成缺陷的关键业务回归测试。
学习目标
- 使用随机端口启动完整 Spring Boot 应用并发起真实 HTTP 请求
- 使用 Testcontainers 提供隔离的 PostgreSQL 与 Kafka 测试环境
- 用最终状态断言替代固定等待,稳定验证异步业务链路
明确端到端测试边界
端到端集成测试关注“用户动作是否得到正确业务结果”,而不是逐个验证内部方法。示例链路为:客户端创建订单,应用写入 PostgreSQL,随后发布 Kafka 消息,消费者处理消息并把订单状态更新为 CONFIRMED。
这类测试应覆盖少量高价值主路径,例如下单、支付回调和库存扣减。它比单元测试慢,因此不适合穷举所有参数组合;输入校验和分支逻辑仍应由单元测试或切片测试承担。

准备测试依赖
以下依赖放入使用 Spring Boot 父 POM 或依赖管理的项目中。spring-boot-starter-test 提供 JUnit 5、AssertJ 和 Awaitility,Testcontainers 模块负责启动真实数据库与 Kafka 容器。
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.testcontainers</groupId>
<artifactId>junit-jupiter</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.testcontainers</groupId>
<artifactId>postgresql</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.testcontainers</groupId>
<artifactId>kafka</artifactId>
<scope>test</scope>
</dependency>
</dependencies>这些依赖生效后,测试运行期间会自动管理容器生命周期,不需要在本机预先安装 PostgreSQL 或 Kafka,但必须有可用的 Docker 兼容运行环境。
编写完整链路测试
下面的测试类假设项目已经提供 POST /api/orders、OrderRepository、订单状态枚举以及 Kafka 消费逻辑。测试使用生产代码的真实 Bean,只替换基础设施地址。
package com.example.order;
import static java.util.Objects.requireNonNull;
import static org.assertj.core.api.Assertions.assertThat;
import static org.awaitility.Awaitility.await;
import java.time.Duration;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.client.TestRestTemplate;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.test.context.DynamicPropertyRegistry;
import org.springframework.test.context.DynamicPropertySource;
import org.testcontainers.containers.KafkaContainer;
import org.testcontainers.containers.PostgreSQLContainer;
import org.testcontainers.junit.jupiter.Container;
import org.testcontainers.junit.jupiter.Testcontainers;
import org.testcontainers.utility.DockerImageName;
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@Testcontainers
class OrderFlowE2ETest {
@Container
static final PostgreSQLContainer<?> POSTGRES =
new PostgreSQLContainer<>("postgres:16-alpine");
@Container
static final KafkaContainer KAFKA =
new KafkaContainer(
DockerImageName.parse("confluentinc/cp-kafka:7.6.1"));
@DynamicPropertySource
static void registerInfrastructure(DynamicPropertyRegistry registry) {
registry.add("spring.datasource.url", POSTGRES::getJdbcUrl);
registry.add("spring.datasource.username", POSTGRES::getUsername);
registry.add("spring.datasource.password", POSTGRES::getPassword);
registry.add("spring.kafka.bootstrap-servers", KAFKA::getBootstrapServers);
registry.add("app.order.topic", () -> "order-created");
}
@Autowired
TestRestTemplate http;
@Autowired
OrderRepository orderRepository;
@Test
void shouldCreateAndConfirmOrder() {
CreateOrderRequest request = new CreateOrderRequest("SKU-1001", 2);
ResponseEntity<OrderResponse> response =
http.postForEntity("/api/orders", request, OrderResponse.class);
assertThat(response.getStatusCode()).isEqualTo(HttpStatus.ACCEPTED);
Long orderId = requireNonNull(response.getBody()).id();
// 消息消费是异步的,因此轮询最终状态,而不是固定 sleep。
await()
.atMost(Duration.ofSeconds(10))
.pollInterval(Duration.ofMillis(200))
.untilAsserted(() -> {
OrderEntity order = orderRepository.findById(orderId)
.orElseThrow();
assertThat(order.getStatus()).isEqualTo(OrderStatus.CONFIRMED);
});
}
record CreateOrderRequest(String sku, int quantity) {}
record OrderResponse(Long id, String status) {}
}@DynamicPropertySource 必须在应用上下文初始化前注册连接信息。若生产环境还依赖 Schema 迁移工具,应让 Flyway 或 Liquibase 在测试容器中照常执行,这样测试才能同时发现迁移脚本与实体映射不一致的问题。
运行并验证结果
只运行这一条端到端测试,便于先确认环境和链路正确:
./mvnw -Dtest=OrderFlowE2ETest test预期输出:
[INFO] Running com.example.order.OrderFlowE2ETest
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS容器启动日志、端口和耗时会因机器不同而变化。测试成功至少说明 HTTP 接口可访问、数据库可写、Kafka 可收发,并且消费者最终完成状态更新。
典型失败与定位顺序
若接口直接返回 500,先查看应用启动和数据库迁移日志;若断言一直等待超时,再检查消息是否发布到正确主题、消费者组是否启动以及事务是否提交。不要第一时间把等待时间调大,否则只会掩盖消息未发送、监听器异常或数据未提交等真实问题。
为避免测试互相污染,每条用例应创建独立业务数据,并通过唯一键或返回的订单 ID 查询结果。并行执行时不要共享固定订单号,也不要依赖测试执行顺序。