lumina: Skill for Claude Code

Lumina 测试规范

功能概述

本技能包用于确保 Lumina 框架项目的测试代码质量，涵盖单元测试与集成测试的编写规范，包括 Mockito Mock 模式、BaseContext ThreadLocal 上下文设置、@Transactional 回滚隔离，以及基于真实 MySQL 的集成测试。

单元测试规范

基本结构

@ExtendWith(MockitoExtension.class)
class UserServiceTest {

    @Mock
    private UserMapper userMapper;

    @InjectMocks
    private UserServiceImpl userService;

    // ...
}

• 使用 @ExtendWith(MockitoExtension.class) 替代 @SpringBootTest，避免启动容器
• Mapper 层用 @Mock 模拟，Service 层用 @InjectMocks 自动注入
• 禁止在单元测试中使用 @Autowired 注入真实 Bean

BaseContext 上下文设置

@BeforeEach
void setUp() {
    BaseContext.setCurrentTenantId(1L);
    BaseContext.setCurrentUserId(100L);
}

@AfterEach
void tearDown() {
    BaseContext.clear();
}

• 每个 @BeforeEach 设置租户/用户上下文（ThreadLocal）
• 每个 @AfterEach 必须调用 BaseContext.clear() 清理 ThreadLocal，防止线程污染
• 忘记清理会导致后续测试的租户隔离失效

断言规范

// 正常用例
assertThat(result.getId()).isNotNull();
assertThat(result.getUsername()).isEqualTo("testuser");

// 异常用例：使用 assertThatThrownBy 验证 BusinessException
assertThatThrownBy(() -> userService.create(dto))
    .isInstanceOf(BusinessException.class)
    .hasMessageContaining("用户名已存在");

// 租户隔离验证
assertThatThrownBy(() -> userService.getById(otherTenantId))
    .isInstanceOf(BusinessException.class);

• 正常用例：使用 AssertJ 的 assertThat 流式断言
• 异常用例：使用 assertThatThrownBy 验证抛出的 BusinessException
• 必须覆盖的场景：租户隔离、admin 保护、边界校验（空值/重复/越权）

集成测试规范

基类继承

class UserIntegrationTest extends BaseIntegrationTest {

    @Autowired
    private UserService userService;

    @Test
    @Transactional
    void createUserAndQuerySuccess() {
        // ...
    }
}

• 所有集成测试继承 BaseIntegrationTest
• BaseIntegrationTest 配置：@SpringBootTest + @ActiveProfiles("test")
• test profile 连接本地 MySQL lumina_dev 数据库
• 使用 @Transactional 保证测试数据自动回滚，不污染数据库

集成测试原则

• 集成测试验证完整调用链路（Controller → Service → Mapper → DB）
• 使用真实数据库验证 SQL 正确性、租户拦截器、权限检查
• 每个 @Transactional 测试方法执行后自动回滚
• 禁止在集成测试中 Mock 数据库层