common-backend-unit-test

name: "common-backend-unit-test" description: "后端单元测试技能。提供后端服务的单元测试指导和生成能力。"

后端单元测试技能

功能描述

提供后端服务的单元测试能力，帮助开发者编写高质量的单元测试，确保代码的正确性和可维护性。

何时使用

在以下情况调用此技能：

• 需要为后端代码编写单元测试时
• 需要评估测试覆盖率时
• 需要优化现有测试时
• 需要生成测试报告时

核心功能

• 测试生成：根据代码生成单元测试用例
• 测试审查：检查测试代码质量和覆盖率
• Mock生成：生成Mock对象和桩代码
• 测试优化：提供测试优化建议
• 报告生成：生成测试覆盖率报告

输入参数

输出格式

{
  "status": "SUCCESS",
  "language": "Java",
  "framework": "JUnit 5",
  "testCode": "生成的测试代码",
  "testCases": [
    {
      "name": "测试用例名称",
      "description": "测试描述",
      "expectedResult": "期望结果"
    }
  ],
  "coverage": {
    "lineCoverage": 85.5,
    "branchCoverage": 78.2,
    "methodCoverage": 90.0
  },
  "suggestions": ["优化建议1", "优化建议2"]
}

单元测试流程

需求分析 → 测试设计 → 测试编写 → 测试执行 → 覆盖率分析 → 优化改进 → 报告生成

详细步骤

1. 需求分析：理解被测代码的功能和行为
2. 测试设计：设计测试用例，覆盖正常和异常场景
3. 测试编写：编写测试代码，使用合适的断言
4. 测试执行：运行测试，验证代码正确性
5. 覆盖率分析：分析测试覆盖率，识别未覆盖的代码
6. 优化改进：根据覆盖率结果补充测试用例
7. 报告生成：生成测试报告和文档

测试质量检查清单

最佳实践指南

JUnit 5 测试规范

@DisplayName("用户服务测试")
class UserServiceTest {
    
    @Mock
    private UserRepository userRepository;
    
    @InjectMocks
    private UserService userService;
    
    @BeforeEach
    void setUp() {
        MockitoAnnotations.openMocks(this);
    }
    
    @Test
    @DisplayName("创建用户 - 成功")
    void createUser_Success() {
        // given
        UserCreateRequest request = new UserCreateRequest("test@example.com");
        User expectedUser = new User("1", "test@example.com");
        when(userRepository.save(any(User.class))).thenReturn(expectedUser);
        
        // when
        User result = userService.createUser(request);
        
        // then
        assertThat(result.getId()).isEqualTo("1");
        verify(userRepository, times(1)).save(any(User.class));
    }
}

测试命名规范

方法名_场景_预期结果

例如：
- createUser_withValidEmail_returnsUser
- createUser_withNullEmail_throwsException
- getUserById_existingId_returnsUser
- getUserById_nonExistingId_returnsNull

Mock 使用原则

1. 隔离外部依赖：使用 Mock 隔离数据库、网络调用等外部依赖
2. 验证交互：验证方法被正确调用
3. 避免过度Mock：只Mock必要的外部依赖，不要Mock被测代码本身
4. 保持简单：Mock配置应简洁明了

测试覆盖率目标

核心组件

配置要求

环境变量

配置文件

testing:
  framework: junit5
  coverage:
    line-threshold: 80
    branch-threshold: 70
    method-threshold: 85
  report:
    format: html
    output-dir: target/site/jacoco

扩展指南

添加新测试框架支持

1. 创建对应框架的测试生成器
2. 定义该框架的测试模板和规范
3. 添加覆盖率分析集成

添加自定义测试规则

1. 在规则引擎中添加新规则
2. 定义规则的检查逻辑和修复建议
3. 更新测试质量检查清单