从JUnit 5迁移至Kotest时Annotation Spec中@Nested注解无法正常工作的问题排查

这个问题我之前也碰到过，其实是Kotest AnnotationSpec对@Nested注解的处理逻辑和JUnit 5不一样导致的，不属于Bug，而是设计上的差异。

问题根源 #

你的Inside类是Kotlin的inner class（内部类），这类类的实例必须依赖外部类Outside的实例才能创建。但Kotest的AnnotationSpec在处理@Nested注解时，并不会自动关联外部类实例来创建内部类对象——它会尝试直接实例化Inside类，这就导致调用runInside方法时，方法所属的对象不是正确的内部类实例，最终抛出java.lang.IllegalArgumentException: object is not an instance of declaring class错误。

而外部类的runOutside方法能正常运行，是因为Kotest能正确创建Outside类的实例并执行其测试方法。

解决办法 #

有两种常用的修复方式：

1. 将内部类改为非内部类（推荐）
   去掉inner关键字，让Inside成为独立的类（对应Java中的静态内部类），这样它就不再依赖外部类实例，Kotest可以直接创建它的实例并执行测试方法：

   class Outside : AnnotationSpec() {
       @Test
       fun runOutside() {
       }
   
       @Nested
       class Inside { // 移除inner关键字
           @Test
           fun runInside() {
           }
       }
   }
   

2. 手动关联外部类实例（仅当需要访问外部类成员时使用）
   如果你确实需要保留内部类来访问外部类的成员，可以在外部类的测试方法中手动创建内部类实例并调用其测试逻辑，但这种方式会偏离@Nested的设计初衷，仅作为临时方案：

   class Outside : AnnotationSpec() {
       @Test
       fun runOutside() {
       }
   
       @Test
       fun runInsideWrapper() {
           Inside().runInside() // 手动创建内部类实例并调用测试方法
       }
   
       inner class Inside {
           fun runInside() {
               // 测试逻辑
           }
       }
   }
   

补充说明 #

Kotest的AnnotationSpec是为了兼容JUnit的注解风格而设计的，但并非100%复刻JUnit 5的行为。JUnit 5会自动处理@Nested内部类的实例化（自动关联外部类实例），而Kotest这里的设计要求@Nested标注的类必须是不依赖外部实例的独立类（非inner类）。

内容的提问来源于stack exchange，提问作者chl