Kotlin的JvmOverloads：让Java调用Kotlin函数不再“尴尬”

上周，我还在为一个老项目头疼。同事在Java代码里调用Kotlin的sendNotification函数，结果被要求传三个参数——明明Kotlin函数里message和priority都有默认值啊！他一脸懵：“这不就该省略吗？” 我当时就笑了：Java不支持默认参数，Kotlin的默认值在Java眼里就是“不存在”。

后来我加了@JvmOverloads，问题瞬间解决了。今天就聊聊这个“救命注解”，不讲教科书，只说实战经验。

为什么Java总“不领情”？

Kotlin的默认参数是语法糖，编译后会生成多个重载方法。但Java不认这套，它只能看到所有参数都必须传。比如：

fun sendNotification(
    title: String,
    message: String = "Hello",
    priority: Int = 1
) {
    // 逻辑
}

在Kotlin里，调用sendNotification("Alert")完全没问题。但Java里得写成：

// Java中必须传三个参数！
NotificationUtil.sendNotification("Alert", "Hello", 1);

——这谁受得了？尤其当默认值是null或常用值时，Java代码瞬间臃肿。

`@JvmOverloads`：一键解决

加个注解，Kotlin编译器就自动为你生成多个重载方法，Java直接“无缝接入”：

@JvmOverloads // 关键！
fun sendNotification(
    title: String,
    message: String = "Hello",
    priority: Int = 1
) {
    println("[$priority] $title: $message")
}

编译后，Java可以这样调：

// 直接省略默认参数！
NotificationUtil.sendNotification("Alert"); // 等价于 (title, "Hello", 1)
NotificationUtil.sendNotification("Warning", "Urgent!"); // (title, message, 1)

效果：Java代码干净得像Kotlin写的。

用起来，别踩坑

只用在函数上：别加在类或属性上，不然编译报错。
默认参数必须在最后：比如fun foo(a: Int, b: String = "default")，如果b在a前面，@JvmOverloads会失效。
别滥用：如果函数参数超过5个，生成的重载方法太多（比如10个），反而增加Java的调用负担。但正常业务函数（3-4个参数）完全没问题。

我的血泪教训

项目里有个fetchData函数，有5个可选参数。我一开始没加@JvmOverloads，Java同事写调用时疯狂传null。后来加了注解，他们直接欢呼：“终于不用写一堆null了！” 现在每次写Kotlin函数，我第一件事就是问：“这会被Java调用吗？”——是的话，@JvmOverloads必须安排上。

最后说句大实话

@JvmOverloads不是Kotlin的“高级特性”，而是互操作性的基础工具。别觉得“我只写Kotlin，不用管Java”。现在跨语言开发太常见了，用好它，能少掉80%的“参数传递”坑。

下次写Kotlin函数时，记得在默认参数的函数上加一行@JvmOverloads——它可能救的不是你，而是下一个被“参数列表”折磨的同事。

（PS：别问为什么叫“JvmOverloads”，反正它能用就行，别较真 😄）