Kotlin数据类构造器平台声明冲突：如何定义同参不同泛型构造器？

问题原因 #

JVM存在泛型擦除机制，List<RecyclerItem>和List<Detail>编译后都会被擦除成原始的List类型，导致你定义的两个构造器在JVM层面的签名完全一致（均为(ILjava/util/List;)V），因此触发Platform declaration clash错误。

可行解决方案 #

方案1：用@JvmName注解修改构造器的JVM名称

给其中一个构造器添加@JvmName注解，强制指定它在JVM中的方法名，让两个构造器的签名区分开：

data class DataItem(val viewType: Int) {
    var recyclerItemList: List<RecyclerItem>? = null
    var detailList: List<Detail>? = null

    constructor(viewType: Int, recyclerItemList: List<RecyclerItem>) : this(viewType) {
        this.recyclerItemList = recyclerItemList
    }

    @JvmName("DataItemWithDetailList")
    constructor(viewType: Int, detailList: List<Detail>) : this(viewType) {
        this.detailList = detailList
    }
}

方案2：用工厂方法替代多构造器

在数据类的companion object中定义静态工厂方法，通过不同的方法名创建实例，彻底避开构造器签名冲突：

data class DataItem(val viewType: Int) {
    var recyclerItemList: List<RecyclerItem>? = null
    var detailList: List<Detail>? = null

    companion object {
        fun fromRecyclerItems(viewType: Int, items: List<RecyclerItem>): DataItem {
            return DataItem(viewType).apply {
                recyclerItemList = items
            }
        }

        fun fromDetails(viewType: Int, details: List<Detail>): DataItem {
            return DataItem(viewType).apply {
                detailList = details
            }
        }
    }
}

使用时直接调用工厂方法：

val recyclerItem = DataItem.fromRecyclerItems(1, listOf(RecyclerItem(1, "img_url")))
val detailItem = DataItem.fromDetails(2, listOf(Detail(0, "height", "100px")))

方案3：重构数据类结构（更推荐）

从设计角度看，一个数据类同时持有两个互斥的列表容易造成状态混乱。可以用密封类拆分数据类，让每种列表对应独立的数据类型：

sealed class BaseDataItem(val viewType: Int)

data class RecyclerDataItem(
    viewType: Int,
    val recyclerItemList: List<RecyclerItem>
) : BaseDataItem(viewType)

data class DetailDataItem(
    viewType: Int,
    val detailList: List<Detail>
) : BaseDataItem(viewType)

这种方式结构清晰，类型安全，从根源上避免了构造器冲突问题。

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