Kotlin数据类MutableList初始化为ImmutableCollections$ListN问题咨询

问题背景 #

参考以下Kotlin代码：

data class CachedUserData(var contracts: MutableList<String>) {
    var localDateTime: LocalDateTime = LocalDateTime.now()
}

通过自动生成的getter获取contracts列表并从外部修改时，会抛出java.lang.UnsupportedOperationException: null异常，排查发现该字段初始化为ImmutableCollections$ListN类型。

通过添加以下修改方法绕过了问题：

fun addContract(item: String) {
    val newList = mutableListOf(*contracts.toTypedArray());
    newList.add(item);
    contracts = newList;
}

调用该方法后，列表类型从ImmutableCollections$ListN变为ArrayList并保持该类型。

该类实例由Java代码创建，传入的是通过网络获取、经Stream过滤后用Java的.toList()收集得到的List<String>。

咨询问题与解答 #

1. 为何明明声明为MutableList，初始类型却为不可变集合？ #

Kotlin的MutableList只是一个接口，仅定义了可修改的集合行为，不限制具体实现类。而Java 16及以上版本中，Stream.toList()返回的是ImmutableCollections.ListN——这是一个不可变的List实现类。

由于Kotlin与Java互操作的特性，Java代码创建CachedUserData实例时，只要传入的对象实现了Java的List接口，就可以赋值给Kotlin的MutableList参数（Kotlin的MutableList在Java层面等价于List）。但ImmutableCollections.ListN不支持修改操作，所以外部调用getContracts().add()时会抛出异常。

2. 是否有办法让初始列表即可修改，直接使用.getContracts().add(value)？ #

有两种可行方案：

• 在Kotlin数据类中做防御性拷贝：修改构造函数，将传入的List主动转换为可变实现类，比如ArrayList：

  data class CachedUserData(contracts: List<String>) {
      var contracts: MutableList<String> = contracts.toMutableList()
      var localDateTime: LocalDateTime = LocalDateTime.now()
  }
  

  toMutableList()默认返回ArrayList，无论Java传入哪种List，最终都会转为可变集合，外部直接调用add()即可生效。
• 在Java侧传入可变集合：创建实例时，将Stream的结果手动转为ArrayList：

  List<String> filteredContracts = stream.filter(...).toList();
  CachedUserData data = new CachedUserData(new ArrayList<>(filteredContracts));
  

  这样传入的是原生可变集合，Kotlin无需额外处理即可直接修改。

3. 该隐式集合转换行为是否有官方详细说明？ #

Kotlin官方文档明确说明了Kotlin与Java集合的互操作规则：

• Kotlin的MutableList/MutableSet等可变集合接口，在Java中对应普通的List/Set接口，Java没有可变集合的专属类型区分。
• Kotlin不会自动将Java传入的List转换为可变实现类，它信任调用方会传入符合MutableList契约（支持修改）的实例。但Java允许传入不可变List实现（比如Stream.toList()、Collections.unmodifiableList()的结果），此时调用修改方法就会抛出UnsupportedOperationException。

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