❀ springboot-tdd是什么？

springboot-tdd 是一个专为 Spring Boot 项目设计的测试驱动开发（TDD）技能。它提供了一套完整的测试工作流，覆盖从单元测试到集成测试的全链路。

核心技术栈：

• JUnit 5 - 测试框架

• Mockito - Mock 框架

• MockMvc - Web 层测试

• Testcontainers - 真实容器测试

• JaCoCo - 代码覆盖率分析

---

❀为什么你需要这个技能？

痛点 1：测试覆盖率低，重构像拆炸弹

没有系统化测试的项目，每次修改代码都提心吊胆。你不知道哪一行改动会引发连锁反应。

这个技能的解法：

通过 TDD 工作流，强制你在写代码前先思考：

• 功能预期行为是什么？

• 边界条件在哪里？

• 失败场景有哪些？

结果？80%+ 测试覆盖率成为标配，重构不再是冒险。

---

痛点 2：测试环境不一致，本地通过线上报错

用 H2 内存数据库测试，生产用 PostgreSQL。某些 SQL 在 H2 里跑得好好的，一上线就炸。

这个技能的解法：

Testcontainers 自动启动真实数据库容器（PostgreSQL、Redis 等），测试环境和生产环境完全一致。

@DynamicPropertySource
static void configureProperties(DynamicPropertyRegistry registry) {
    registry.add("spring.datasource.url", postgres::getJdbcUrl);
    registry.add("spring.datasource.username", postgres::getUsername);
    registry.add("spring.datasource.password", postgres::getPassword);
}

---

痛点 3：测试写得混乱，调试像在黑暗中找针

所有测试混在一起，不知道是单元测试还是集成测试，出问题时排查困难。

这个技能的解法：

清晰的四层测试金字塔架构：

层级	注解	测试内容	速度
单元测试	@Mock  + @InjectMocks	单个类逻辑	⚡ 最快
Web 层测试	@WebMvcTest	Controller HTTP 交互	⚡ 快
集成测试	@SpringBootTest	端到端流程	🐌 较慢
持久层测试	@DataJpaTest	Repository 数据库操作	⚡ 快

每层职责清晰，问题定位效率提升 10 倍。

---

❀这个技能能给你带来什么价值？

价值 1：代码质量提升 

• 强制思考

  ：先写测试倒逼你想清楚需求

• 即时反馈

  ：测试失败立即发现问题，而不是上线后

• 安全网

  ：重构时有测试保护，大胆改进代码结构

价值 2：开发效率不降反升

很多人误以为写测试会拖慢开发速度。真相是：

• 调试时间减少（问题在测试阶段就被捕获）

• Bug 修复成本降低 （越早发现问题，修复成本越低）

• 新人上手更快（测试就是最佳文档）

价值 3：团队协作更顺畅

• 测试即文档：新成员通过测试快速理解业务逻辑

• 代码审查更高效：PR 附带测试，Review 更有信心

• 持续集成更可靠：自动化测试保障每次提交质量

---

❀核心功能一览

✅ 完整 TDD 工作流

1️⃣ 先写失败的测试
2️⃣ 写最小代码让测试通过
3️⃣ 重构代码保持测试绿色
4️⃣ 用 JaCoCo 验证覆盖率

✅ 分层测试模板

单元测试（JUnit 5 + Mockito）

@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());
    }
}

Web 层测试（MockMvc）

@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）

@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());
    }
}

✅ Testcontainers 真实环境测试

告别 Mock 数据库，用真实容器测试：

• 自动启动 PostgreSQL/Redis 容器

• 测试完成后自动销毁

• 容器可复用，不拖慢测试速度

✅ JaCoCo 覆盖率监控

<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>

运行 mvn verify 生成详细覆盖率报告。

✅ 测试最佳实践

• Arrange-Act-Assert

   模式

• AssertJ

   流畅断言

• Test Data Builder

   模式

• 测试行为而非实现细节

---

❀什么时候应该使用这个技能？

✅ 开发新功能 - 先写测试明确需求边界
✅ 修复 Bug - 先写复现测试，确保问题不再回归
✅ 代码重构 - 有测试保护，大胆改进架构
✅ 添加数据访问逻辑 - 用 Testcontainers 验证真实 SQL
✅ 实现安全规则 - 用测试覆盖所有权限场景

---

❀快速上手

Maven 项目

# 运行测试
mvn -T 4 test

# 生成覆盖率报告
mvn verify

Gradle 项目

# 运行测试
./gradlew test

# 生成覆盖率报告
./gradlew jacocoTestReport

---

❀实战建议

建议 1：从小处开始

不要试图一次性给老项目补全测试。从新功能开始实践 TDD，逐步积累。

建议 2：覆盖率目标 80%+

• 单元测试覆盖核心业务逻辑

• 集成测试覆盖关键 API 端点

• 不要盲目追求 100%，关注边界条件

建议 3：测试要快速、隔离、确定性

• 快速

  ：单个测试不超过 1 秒

• 隔离

  ：测试之间不互相依赖

• 确定性

  ：同样输入永远得到同样输出

建议 4：测行为，别测实现

// ❌ 错误：测试实现细节
verify(helper).methodA();
verify(helper).methodB();

// ✅ 正确：测试行为结果
assertThat(result.getStatus()).isEqualTo(ACTIVE);

---

通义灵码实战过程

1.使用技能生成测试用例：

2.自主规划任务计划

3.自主编写测试用例

4.测试用例自动化执行

5.报告生成

6.Jacoco报告生成

❀总结

springboot-tdd 不只是一个测试技能，它是一套质量保障体系。

它帮你：

• 🎯 建立系统化测试思维

• 🛡️ 构建代码安全网

• ⚡ 提升开发和调试效率

• 📊 量化代码质量

• 🤝 改善团队协作

投资测试，就是投资项目的未来。

当你开始用 TDD 工作流，你会发现：

不是"写测试拖慢了开发"，而是"没有测试才在后期付出十倍代价"。

---

准备好了吗？下次开发新功能时，试着先写一个会失败的测试。

你会发现，代码质量自然跟上。