如何在Kotest中编写断言抛出异常的测试用例？

我想通过测试覆盖抛出异常的场景，尝试传入错误输入但没成功。请问在Kotest中，能不能在调用函数时显式断言抛出异常？我在Kotest文档里没找到相关场景的说明，相关代码如下：

Main.kt #

parseEvent(input).forEach { event ->
    try {
        eventsProcessor(event)
    } catch (ex: Exception) {
        log.error { ex }
        batchItemFailures.add(SQSBatchResponse.BatchItemFailure(event.msgId))
    }
}

private fun eventsProcessor(event: Event<*>) {
    try {
        when (event.type) {
            "xyz" -> dailyprocess()
            else -> log.warn { "Unknown event type: ${event.type}" }
        }
    } catch (ex: Exception) {
        log.error { ex }
        throw ex
    }
}

Test.kt #

describe("Event parsing") {

    context("when event is just a map") {
        val event = mapOf(
            "Records" to listOf(
                mapOf("body" to "jsonBody1")))

        it("parses and process event") {

            handler.handleRequest(event, createTestContext())
            val exception = shouldThrow<Exception> {
                dailyprocess(Instant.now())
            }

        }
    }
}

Kotest完全支持显式断言函数抛出异常，核心用shouldThrow函数即可，但你的测试代码存在流程脱节的问题，导致没覆盖到目标场景，下面给出修正方案：

问题分析 #

你的测试直接单独调用dailyprocess，但实际业务中该函数是在eventsProcessor处理类型为"xyz"的事件时才会执行，且外层循环会捕获eventsProcessor抛出的异常并添加到batchItemFailures，不会向上抛出。当前测试与实际业务流程分离，无法触发你想要的异常场景。

解决方案 #

1. 单元测试：直接测试目标函数

针对eventsProcessor或dailyprocess单独测试，用shouldThrow包裹调用逻辑：

describe("Event processing") {
    context("when handling 'xyz' type event") {
        it("throws exception if dailyprocess fails") {
            // 构造符合条件的Event对象
            val testEvent = Event(type = "xyz", msgId = "test-123")
            
            // 断言调用eventsProcessor时会抛出指定类型异常
            val exception = shouldThrow<Exception> {
                eventsProcessor(testEvent)
            }
            
            // 可选：进一步验证异常细节
            exception shouldBeInstanceOf RuntimeException::class
            exception.message shouldContain "预期的错误提示"
        }
    }
    
    context("dailyprocess function") {
        it("throws exception with invalid input") {
            // 传入会触发异常的参数
            val exception = shouldThrow<IllegalArgumentException> {
                dailyprocess(Instant.parse("invalid-timestamp"))
            }
        }
    }
}

2. 集成测试：验证完整流程的异常处理

如果要测试handler.handleRequest的完整流程，由于外层代码捕获异常并记录到batchItemFailures，此时需要断言失败项是否正确添加：

describe("Handler request processing") {
    context("when event processing throws exception") {
        it("adds failure to batchItemFailures") {
            // 构造会触发异常的输入（确保parseEvent后得到type为"xyz"的Event）
            val faultyEvent = mapOf(
                "Records" to listOf(
                    mapOf("body" to "{\"type\":\"xyz\",\"msgId\":\"fail-456\"}")))
            
            handler.handleRequest(faultyEvent, createTestContext())
            
            // 断言失败列表包含对应的msgId
            handler.batchItemFailures shouldHaveSize 1
            handler.batchItemFailures.first().itemIdentifier shouldBe "fail-456"
        }
    }
}

Kotest异常断言补充 #

• shouldThrow<ExceptionType>：执行闭包代码，若未抛出指定类型（或子类）异常则测试失败，返回异常对象供后续断言。
• shouldThrowExactly<ExceptionType>：严格断言抛出的是指定精确类型的异常（不包含子类）。
• shouldNotThrow<ExceptionType>：断言闭包代码不会抛出指定类型的异常。

内容的提问来源于stack exchange，提问作者rahul.cs