使用Kotlin buildList构建列表导致单元测试失败的问题

根据你描述的现象（buildList()替代mutableListOf()后单元测试失败，但运行时正常），结合代码细节，最可能的原因如下：

1. List实现类差异导致的测试匹配问题 #

Kotlin的buildList()返回的是不可变List的特定实现（比如单元素场景返回SingletonList，空列表返回EmptyList），而mutableListOf()返回的是ArrayList（你直接返回这个MutableList，实际类型为ArrayList）。

虽然从List接口契约来看，两个列表的equals()应该返回true（内容完全一致），但在某些旧版本的Mockito或JUnit中，可能存在特殊List实现的兼容性问题：

• 部分测试库在参数匹配或断言时，错误依赖了List的具体类型而非内容
• Mockito的ArgumentCaptor在捕获不可变List时，可能出现内部逻辑异常（比如无法正确解析元素）

2. 意外的作用域冲突（Lambda中的add方法指向错误） #

如果你的类中存在同名的add方法（比如当前类有fun add(item: SomeType)），在buildList的Lambda中直接调用add(UIModel1.EmptyView)时，可能误调用外部类的add方法，而非MutableList的add方法。这种情况下，buildList返回的列表是空的，直接导致断言失败。

验证方式：在Lambda中显式指定this.add（指向MutableList）：

return buildList {
    if (list.isEmpty()) {
        this.add(UIModel1.EmptyView) // 明确调用MutableList的add方法
    } else {
        this.addAll(/* ... */)
    }
}

3. RxJava测试的线程同步问题 #

你的测试依赖RxJava的Observable，如果测试中未指定TestScheduler并同步调度，可能出现异步执行的时序问题：

• 主线程执行完verify和assertEquals时，buildUIList的代码还未在后台线程执行完毕
• 而mutableListOf的实现可能因代码执行更快，巧合地在断言前完成了执行

解决方式：在测试中使用RxJava的测试调度器，确保所有异步操作同步完成：

@Before
fun setup() {
    RxJavaPlugins.setIoSchedulerHandler { Schedulers.trampoline() }
    RxJavaPlugins.setComputationSchedulerHandler { Schedulers.trampoline() }
    RxJavaPlugins.setNewThreadSchedulerHandler { Schedulers.trampoline() }
}

@After
fun teardown() {
    RxJavaPlugins.reset()
}

4. UIModel1的equals/hashCode实现问题 #

如果UIModel1.EmptyView不是data class或object，且未正确重写equals()和hashCode()，即使两个列表的元素看起来相同，assertEquals也会因为引用不相等而失败。

验证方式：检查UIModel1的实现，确保EmptyView是单例（比如用object声明），或者重写equals()方法：

sealed class UIModel1 {
    object EmptyView : UIModel1() // 单例，默认equals基于引用比较，同一实例会相等
}

1. 先在buildList的实现中，将返回值转为ArrayList，看测试是否通过：

return buildList {
    // ... 原有逻辑
}.toMutableList() // 转为ArrayList类型

如果测试通过，说明是List实现类的问题。

2. 打印captor1.firstValue和listOf(UIModel1.EmptyView)的内容、类型和哈希值，对比差异：

println("Captured list: ${captor1.firstValue}, type: ${captor1.firstValue::class.java}, hash: ${captor1.firstValue.hashCode()}")
println("Expected list: ${listOf(UIModel1.EmptyView)}, type: ${listOf(UIModel1.EmptyView)::class.java}, hash: ${listOf(UIModel1.EmptyView).hashCode()}")
println("Equals result: ${captor1.firstValue == listOf(UIModel1.EmptyView)}")

通过日志可以直接定位是内容不相等，还是类型导致的断言问题。

内容的提问来源于stack exchange，提问作者Nacho Ramos Sánche