Kotlin调用Mailgun Java API时.to方法与Pair创建函数冲突问题

在使用Mailgun Java API构建邮件时，调用MessageBuilder的.to(recipient)方法填充收件人时，会遇到编译器歧义问题：Kotlin会将该方法识别为标准库中用于创建Pair的infix fun <A, B> A.to(that: B): Pair<A, B>函数，而非Mailgun API提供的实例方法，最终导致后续的.build()提示“未解析引用”。

初始代码示例：

Message.builder()
    .from(emailAddress)
    .subject(subject)
    .attachment(File("/path/to/file"))
    .to(recipient)
    .build()

已尝试的无效操作：

• 用反引号包裹.to(recipient)调用，未解决歧义
• 尝试导入该方法，收到提示：

  Cannot import 'to', functions and properties can be imported only from packages or objects

• 创建扩展函数，但无法访问MessageBuilder的私有to属性，无法实现

可行解决方案 #

1. 用let明确指定调用实例方法

通过let函数显式绑定当前MessageBuilder实例，让编译器明确调用目标方法：

Message.builder()
    .from(emailAddress)
    .subject(subject)
    .attachment(File("/path/to/file"))
    .let { it.to(recipient) }
    .build()

2. 拆分链式调用

将.to(recipient)从链式调用中拆分出来，单独调用，避免编译器混淆：

val messageBuilder = Message.builder()
    .from(emailAddress)
    .subject(subject)
    .attachment(File("/path/to/file"))

messageBuilder.to(recipient)
val message = messageBuilder.build()

3. 替换为API的其他重载方法

如果你的Mailgun API版本提供了其他收件人方法（比如.addTo()），可以直接替换使用，避开方法名冲突：

Message.builder()
    .from(emailAddress)
    .subject(subject)
    .attachment(File("/path/to/file"))
    .addTo(recipient)
    .build()

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