testing-strategies

测试策略 — 快速参考

有关 @MicronautTest 配置、Retrofit 客户端设置和连接池调优，请参阅 integration-test-setup.md。

有关完整代码模式，包括 MockK、测试数据构建器和断言，请参阅 examples.md。

集成测试

每个端点都需要集成测试。继承 AbstractControllerTest，使用 module-client 中的 Retrofit 客户端，并在 @AfterEach 中通过 truncateAllTables() 清理数据。

关键规则：

• 始终使用 Retrofit 客户端 — 不要使用原始 HttpRequest
• 通过 accessToken() 生成真实的 JWT 令牌
• 端到端测试完整的 HTTP 堆栈，不要模拟管理器

测试命名

@Test
fun `{action} - {expected outcome}`() = runBlocking { }

// Examples:
fun `getEmployee - returns employee by id`() = runBlocking { }
fun `getEmployee - returns 404 when not found`() = runBlocking { }
fun `createEmployee - fails with 401 when not authenticated`() = runBlocking { }

每个端点的必需测试覆盖

1. 正常路径 — 基本成功场景
2. 未找到 — 缺少资源时返回 404
3. 认证失败 — 不带令牌时返回 401
4. 软删除 — 不返回已删除的记录

@Test
fun `getById - returns 404 when not found`() = runBlocking {
  val token = accessToken(prepareUser())
  assertThrows<HttpException> {
    runBlocking {
      client.getById(authorization = token, id = UUID.randomUUID())
    }
  }.also {
    assertThat(it.code()).isEqualTo(404)
  }
}

仓库测试

继承 AbstractRepositoryTest。每个仓库至少需要通过以下测试：

class DefaultEmployeeRepositoryTest : AbstractRepositoryTest() {

  private val repository = DefaultEmployeeRepository(database)

  @BeforeEach
  fun cleanup() { database.primary.truncateAllTables() }

  @Test
  fun `insert - happy path`() { }

  @Test
  fun `byId - returns entity when exists`() { }

  @Test
  fun `byId - returns null when not exists`() { }

  @Test
  fun `byId - returns null when soft deleted`() { }

  @Test
  fun `deleteById - soft deletes entity`() { }

  @Test
  fun `update - updates selected fields`() { }
}

MockK 规则

• 使用 mockk<T>() 创建模拟对象
• 对挂起函数使用 coEvery / coVerify（不要使用 every / verify）
• 使用 slot<T>() + capture() 验证传入的参数
• 使用 kotlinx.coroutines.test 中的 runTest { } — 不要使用 runBlocking。runTest 会处理虚拟时间并捕获协程问题。
• 使用带注释的 AAA 模式：// Given、// When、// Then
• 使用 @Nested + @DisplayName 对相关测试分组

有关完整的 MockK 代码示例、@Nested 模式、测试数据构建器和 AssertJ 断言，请参阅 examples.md。

注意事项

连接池耗尽： 如果并行测试因 “cannot acquire connection” 失败，请将 maxPoolSize 提高到 20。配置片段请参阅 integration-test-setup.md。

MockK + 协程： 对挂起函数始终使用 coEvery / coVerify。普通的 every / verify 不起作用，还会产生令人困惑的错误。

运行测试

./gradlew test                                                    # All tests
./gradlew test --tests "com.yourcompany.EmployeeControllerTest"   # One class
./gradlew :app:module-repository:test                             # One module