SKILL推荐实战 - 80%测试覆盖率不是梦，而是标准工作流
❀ 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+ | 单个类逻辑 | ⚡ 最快 |
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 verifyGradle 项目
# 运行测试 ./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 工作流，你会发现：
不是"写测试拖慢了开发"，而是"没有测试才在后期付出十倍代价"。
准备好了吗？下次开发新功能时，试着先写一个会失败的测试。
你会发现，代码质量自然跟上。