函数扩展重载引发类型推断失败，求不改名的惯用声明方式

这个类型推断冲突的问题我之前也碰到过，本质是你定义的三个toJson扩展函数签名在编译器看来太模糊了——第一个针对所有T的泛型函数会覆盖List、Page这类特殊类型，导致编译器没法判断该选哪个候选函数。下面给你几个符合Kotlin惯用风格的解决办法，全程不用修改函数名：

最推荐的方案：明确指定每个扩展的返回类型 #

编译器之所以纠结，很大程度是因为三个函数的返回类型都被推断成了模糊的JsonResult<*>。只要给每个扩展函数明确标注返回类型，编译器就能通过返回类型的差异自动匹配正确的函数：

// 普通对象：返回单个转换后的结果包装
fun <T, R> T.toJson(transform: (T) -> R): JsonResult<R> = JsonResult(transform(this))

// List集合：返回转换后的列表包装
fun <T, R> List<T>.toJson(transform: (T) -> R): JsonResult<List<R>> = JsonResult(this.map(transform))

// Page分页对象：返回分页内容转换后的列表包装
fun <T, R> Page<T>.toJson(transform: (T) -> R): JsonResult<List<R>> = JsonResult(this.content.map(transform))

这样调用时，编译器会根据你调用的对象类型和lambda的返回结果自动匹配：

val person = Person()
val personJson = person.toJson { it.name } // 自动匹配普通对象的扩展，返回JsonResult<String>

val people = listOf(Person(), Person())
val peopleJson = people.toJson { it.name } // 自动匹配List的扩展，返回JsonResult<List<String>>

val pageablePeople = Page.empty<Person>()
val pageJson = pageablePeople.toJson { it.name } // 自动匹配Page的扩展，返回JsonResult<List<String>>

进阶方案：用具体化泛型做运行时安全检查 #

如果你想进一步避免误用（比如有人不小心用List调用了普通对象的扩展），可以结合inline和reified泛型做运行时检查，同时保留自动匹配的能力：

inline fun <reified T, R> T.toJson(transform: (T) -> R): JsonResult<R> {
    require(!(this is List<*> || this is Page<*>)) {
        "请使用List/Page专属的toJson方法"
    }
    return JsonResult(transform(this))
}

// 保留List和Page的明确返回类型扩展
fun <T, R> List<T>.toJson(transform: (T) -> R): JsonResult<List<R>> = JsonResult(this.map(transform))
fun <T, R> Page<T>.toJson(transform: (T) -> R): JsonResult<List<R>> = JsonResult(this.content.map(transform))

这个方案在编译时依然会优先选择List/Page的专属扩展，同时给普通对象的扩展加了一层运行时防护，防止意外调用。

原理补充 #

Kotlin的扩展函数匹配遵循更具体优先的规则：当一个对象同时符合多个扩展函数的接收者类型时，编译器会优先选择最具体的那个类型扩展。之前的问题是因为三个函数的返回类型没有明确差异，导致编译器无法快速区分候选；一旦明确了返回类型，编译器就能结合接收者类型和返回类型的预期，准确匹配到对应的扩展函数。

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