Java 后端 / 系统课时

编写端到端集成测试

编写端到端集成测试

本课用一个订单链路示例,把 HTTP 请求、数据库写入和 Kafka 异步消费放进同一个 @SpringBootTest 中验证。完成后,你将拥有一条可重复执行、能发现跨组件集成缺陷的关键业务回归测试。

学习目标

  • 使用随机端口启动完整 Spring Boot 应用并发起真实 HTTP 请求
  • 使用 Testcontainers 提供隔离的 PostgreSQL 与 Kafka 测试环境
  • 用最终状态断言替代固定等待,稳定验证异步业务链路

明确端到端测试边界

端到端集成测试关注“用户动作是否得到正确业务结果”,而不是逐个验证内部方法。示例链路为:客户端创建订单,应用写入 PostgreSQL,随后发布 Kafka 消息,消费者处理消息并把订单状态更新为 CONFIRMED。

这类测试应覆盖少量高价值主路径,例如下单、支付回调和库存扣减。它比单元测试慢,因此不适合穷举所有参数组合;输入校验和分支逻辑仍应由单元测试或切片测试承担。

HTTP、数据库与消息端到端测试链路

准备测试依赖

以下依赖放入使用 Spring Boot 父 POM 或依赖管理的项目中。spring-boot-starter-test 提供 JUnit 5、AssertJ 和 Awaitility,Testcontainers 模块负责启动真实数据库与 Kafka 容器。

xml
<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,只替换基础设施地址。

java
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 在测试容器中照常执行,这样测试才能同时发现迁移脚本与实体映射不一致的问题。

运行并验证结果

只运行这一条端到端测试,便于先确认环境和链路正确:

bash
./mvnw -Dtest=OrderFlowE2ETest test

预期输出:

text
[INFO] Running com.example.order.OrderFlowE2ETest
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

容器启动日志、端口和耗时会因机器不同而变化。测试成功至少说明 HTTP 接口可访问、数据库可写、Kafka 可收发,并且消费者最终完成状态更新。

典型失败与定位顺序

若接口直接返回 500,先查看应用启动和数据库迁移日志;若断言一直等待超时,再检查消息是否发布到正确主题、消费者组是否启动以及事务是否提交。不要第一时间把等待时间调大,否则只会掩盖消息未发送、监听器异常或数据未提交等真实问题。

为避免测试互相污染,每条用例应创建独立业务数据,并通过唯一键或返回的订单 ID 查询结果。并行执行时不要共享固定订单号,也不要依赖测试执行顺序。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写端到端集成测试

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通