Kotest框架中assertSoftly断言堆栈丢失问题分析

问题背景

在Kotest测试框架中，开发者经常使用assertSoftly块来执行多个断言，即使其中某些断言失败，也会继续执行后续断言并最终汇总所有错误。然而，在某些特定情况下，这个功能会出现堆栈跟踪信息丢失的问题，导致开发者难以准确定位失败的断言位置。

问题现象

当满足以下两个条件时，堆栈跟踪会指向assertSoftly块的开始位置，而不是实际的断言失败位置：

1. assertSoftly块中只收集到一个断言错误
2. 断言错误的类型不是标准的AssertionFailedError(例如是普通的AssertionError)

技术分析

从技术实现角度来看，这个问题源于Kotest对错误处理的逻辑差异。当多个断言失败时，框架会创建一个复合错误对象，其中包含了所有失败的断言及其准确的堆栈信息。但当只有一个错误且类型不匹配时，框架会直接抛出原始错误，而没有进行适当的堆栈信息调整。

影响范围

这个问题在普通使用场景下影响不大，因为堆栈仍然会指向assertSoftly块，开发者可以大致定位问题区域。但当启用全局软断言设置(kotest.framework.assertion.globalassertsoftly = true)时，问题会变得更加严重，因为所有断言都隐式地包裹在软断言中，导致调试变得困难。

解决方案

Kotest开发团队已经修复了这个问题，修复方案主要包括：

1. 统一错误处理路径，确保所有类型的断言错误都经过相同的堆栈信息处理流程
2. 无论错误数量多少，都保持一致的堆栈信息展示方式
3. 对非标准断言错误类型进行适当包装，确保堆栈信息的准确性

最佳实践

为了避免类似问题，建议开发者：

1. 尽量使用Kotest提供的标准断言方法，它们会产生AssertionFailedError
2. 在自定义断言中，遵循Kotest的错误类型规范
3. 定期更新Kotest版本以获取最新的错误修复和功能改进

总结

堆栈信息对于测试失败调试至关重要。Kotest框架通过持续改进确保了在各种断言场景下都能提供准确的错误定位信息。开发者了解这些细节有助于更高效地编写和维护测试代码。