Springboot Tdd

affaan-m/ECC/docs/zh-CN/skills/springboot-tdd

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775无许可证275K 个星标收录于 2026年10月9日更新于 2026年10月9日仓库4天前更新

使用JUnit 5、Mockito、MockMvc、Testcontainers和JaCoCo进行Spring Boot的测试驱动开发。适用于添加功能、修复错误或重构时。

仅含说明Software Development

AI 生成的概览

指导 Spring Boot 服务的测试驱动开发，使用 JUnit 5、Mockito、MockMvc、Testcontainers 和 JaCoCo。

功能: 该技能为 Spring Boot 服务提供 TDD 工作流程指南，涵盖先写测试、实现、重构的循环，并以 80% 以上覆盖率为目标。它给出单元测试（JUnit 5 与 Mockito）、Web 层测试（MockMvc）、集成测试（SpringBootTest）以及持久层测试（DataJpaTest 与 Testcontainers）的代码模式。此外还包含 JaCoCo 的 Maven 配置、断言建议、测试数据构建器示例，以及 Maven 和 Gradle 的 CI 命令。
适用场景: 适用于为 Spring Boot 服务添加新功能或端点、修复缺陷、重构，或添加数据访问逻辑与安全规则的场景。也适合希望采用结构化测试先行方法并强制覆盖率的团队。
运行要求: 仅为说明文档，不附带脚本。按指南操作需要具备 JUnit 5、Mockito、MockMvc、Testcontainers 和 JaCoCo 的 Spring Boot 项目，以及 Maven 或 Gradle，并为 Testcontainers 提供容器运行时。

Spring Boot TDD 工作流程

适用于 Spring Boot 服务、覆盖率 80%+（单元 + 集成）的 TDD 指南。

何时使用

新功能或端点
错误修复或重构
添加数据访问逻辑或安全规则

工作流程

先写测试（它们应该失败）
实现最小代码以通过测试
在测试通过后进行重构
强制覆盖率（JaCoCo）

单元测试 (JUnit 5 + Mockito)

java

@ExtendWith(MockitoExtension.class)class MarketServiceTest {  @Mock MarketRepository repo;  @InjectMocks MarketService service;
  @Test  void createsMarket() {    CreateMarketRequest req = new CreateMarketRequest("name", "desc", Instant.now(), List.of("cat"));    when(repo.save(any())).thenAnswer(inv -> inv.getArgument(0));
    Market result = service.create(req);
    assertThat(result.name()).isEqualTo("name");    verify(repo).save(any());  }}

@ExtendWith(MockitoExtension.class)class MarketServiceTest {  @Mock MarketRepository repo;  @InjectMocks MarketService service;
  @Test  void createsMarket() {    CreateMarketRequest req = new CreateMarketRequest("name", "desc", Instant.now(), List.of("cat"));    when(repo.save(any())).thenAnswer(inv -> inv.getArgument(0));
    Market result = service.create(req);
    assertThat(result.name()).isEqualTo("name");    verify(repo).save(any());  }}

模式：

Arrange-Act-Assert
避免部分模拟；优先使用显式桩
使用 @ParameterizedTest 处理变体

Web 层测试 (MockMvc)

java

@WebMvcTest(MarketController.class)class MarketControllerTest {  @Autowired MockMvc mockMvc;  @MockBean MarketService marketService;
  @Test  void returnsMarkets() throws Exception {    when(marketService.list(any())).thenReturn(Page.empty());
    mockMvc.perform(get("/api/markets"))        .andExpect(status().isOk())        .andExpect(jsonPath("$.content").isArray());  }}

@WebMvcTest(MarketController.class)class MarketControllerTest {  @Autowired MockMvc mockMvc;  @MockBean MarketService marketService;
  @Test  void returnsMarkets() throws Exception {    when(marketService.list(any())).thenReturn(Page.empty());
    mockMvc.perform(get("/api/markets"))        .andExpect(status().isOk())        .andExpect(jsonPath("$.content").isArray());  }}

集成测试 (SpringBootTest)

java

@SpringBootTest@AutoConfigureMockMvc@ActiveProfiles("test")class MarketIntegrationTest {  @Autowired MockMvc mockMvc;
  @Test  void createsMarket() throws Exception {    mockMvc.perform(post("/api/markets")        .contentType(MediaType.APPLICATION_JSON)        .content("""          {"name":"Test","description":"Desc","endDate":"2030-01-01T00:00:00Z","categories":["general"]}        """))      .andExpect(status().isCreated());  }}

@SpringBootTest@AutoConfigureMockMvc@ActiveProfiles("test")class MarketIntegrationTest {  @Autowired MockMvc mockMvc;
  @Test  void createsMarket() throws Exception {    mockMvc.perform(post("/api/markets")        .contentType(MediaType.APPLICATION_JSON)        .content("""          {"name":"Test","description":"Desc","endDate":"2030-01-01T00:00:00Z","categories":["general"]}        """))      .andExpect(status().isCreated());  }}

持久层测试 (DataJpaTest)

java

@DataJpaTest@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)@Import(TestContainersConfig.class)class MarketRepositoryTest {  @Autowired MarketRepository repo;
  @Test  void savesAndFinds() {    MarketEntity entity = new MarketEntity();    entity.setName("Test");    repo.save(entity);
    Optional<MarketEntity> found = repo.findByName("Test");    assertThat(found).isPresent();  }}

@DataJpaTest@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)@Import(TestContainersConfig.class)class MarketRepositoryTest {  @Autowired MarketRepository repo;
  @Test  void savesAndFinds() {    MarketEntity entity = new MarketEntity();    entity.setName("Test");    repo.save(entity);
    Optional<MarketEntity> found = repo.findByName("Test");    assertThat(found).isPresent();  }}

Testcontainers

对 Postgres/Redis 使用可复用的容器以镜像生产环境
通过 @DynamicPropertySource 连接，将 JDBC URL 注入 Spring 上下文

覆盖率 (JaCoCo)

Maven 片段：

xml

<plugin>  <groupId>org.jacoco</groupId>  <artifactId>jacoco-maven-plugin</artifactId>  <version>0.8.14</version>  <executions>    <execution>      <goals><goal>prepare-agent</goal></goals>    </execution>    <execution>      <id>report</id>      <phase>verify</phase>      <goals><goal>report</goal></goals>    </execution>  </executions></plugin>

<plugin>  <groupId>org.jacoco</groupId>  <artifactId>jacoco-maven-plugin</artifactId>  <version>0.8.14</version>  <executions>    <execution>      <goals><goal>prepare-agent</goal></goals>    </execution>    <execution>      <id>report</id>      <phase>verify</phase>      <goals><goal>report</goal></goals>    </execution>  </executions></plugin>

断言

为可读性，优先使用 AssertJ (assertThat)
对于 JSON 响应，使用 jsonPath
对于异常：assertThatThrownBy(...)

测试数据构建器

java

class MarketBuilder {  private String name = "Test";  MarketBuilder withName(String name) { this.name = name; return this; }  Market build() { return new Market(null, name, MarketStatus.ACTIVE); }}

class MarketBuilder {  private String name = "Test";  MarketBuilder withName(String name) { this.name = name; return this; }  Market build() { return new Market(null, name, MarketStatus.ACTIVE); }}

CI 命令

Maven: mvn -T 4 test 或 mvn verify
Gradle: ./gradlew test jacocoTestReport

记住：保持测试快速、隔离且确定。测试行为，而非实现细节。

来源与署名

来源：affaan-m/ECC位于docs/zh-CN/skills/springboot-tdd提交ef648e0

许可证：无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

Springboot Tdd

Spring Boot TDD 工作流程

何时使用

工作流程

单元测试 (JUnit 5 + Mockito)

Web 层测试 (MockMvc)

集成测试 (SpringBootTest)

持久层测试 (DataJpaTest)

Testcontainers

覆盖率 (JaCoCo)

断言

测试数据构建器

CI 命令

来源与署名

更多来自 affaan-m/ECC 的技能

Unified Notifications Ops

Verification Loop

Ui To Vue

Unified Memory

Visa Doc Translate

Team Builder

更多Software Development技能

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices