JavaMail环境下如何检测自定义SMTP服务器是否支持SMTPUTF8

你提出的第一种技术自动检测方案完全可行，不需要用户手动配置，避免普通用户不了解相关参数导致配置错误。

你提到的开启参数后服务器不支持时的日志提示如下：

mail.mime.allowutf8 set but server doesn't advertise SMTPUTF8 support

正确实现步骤 #

你不需要直接实例化SMTPTransport，也不需要手动处理连接逻辑，按照以下方式通过JavaMail标准API获取实例即可：

• 构造与发信逻辑完全一致的Session配置，包含SMTP服务器地址、端口、加密方式、认证信息等参数，保证检测环境和实际发信环境一致
• 从Session中获取SMTP传输实例，连接成功后调用supportsExtension方法检测SMTPUTF8扩展支持情况
• 检测完成后关闭连接，整个过程不会发送实际邮件，对服务器没有额外压力

代码示例 #

import com.sun.mail.smtp.SMTPTransport;
import javax.mail.Session;
import javax.mail.URLName;
import java.util.Properties;

public class SmtpUtf8Checker {
    public boolean checkSmtpUtf8Support(Properties smtpProps, String host, int port, String username, String password) throws Exception {
        Session session = Session.getInstance(smtpProps);
        // 构造SMTP连接的URLName
        URLName urlName = new URLName("smtp", host, port, null, username, password);
        try (SMTPTransport transport = (SMTPTransport) session.getTransport(urlName)) {
            // 连接服务器
            transport.connect();
            // 检测是否支持SMTPUTF8扩展
            return transport.supportsExtension("SMTPUTF8");
        }
    }
}

补充说明 #

• 可以在用户新增SMTP配置时自动执行上述检测逻辑，将结果存储到你的配置库中，发信时直接读取结果即可，不需要每次发信都重复检测
• 若检测结果为支持，再设置mail.mime.allowutf8参数为true，即可完全避免你提到的警告日志
• 若检测结果为不支持，不要开启上述参数，JavaMail会自动对包含UTF-8字符的邮件内容、标题、收件人等进行标准MIME编码，保证邮件正常投递
• 你担心的直接依赖com.sun包的问题不需要过度顾虑：supportsExtension是SMTPTransport类的公开方法，从JavaMail 1.6版本到后续的Jakarta Mail版本，该方法签名一直保持稳定，不存在兼容性风险；如果后续切换到Jakarta Mail实现，仅需要将导入包替换为org.eclipse.angus.mail.smtp.SMTPTransport即可，业务逻辑不需要修改

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