Java SendMail代码仅在开发机正常，部署后失效如何排查？

问题描述 #

在Apache NetBeans中编写的Java SendMail代码（如下）可在开发电脑正常运行，但打包成安装程序部署到其他电脑后无法发送邮件，需排查两台机器的差异并定位故障原因。

String host = "smtp.xxxxx.com";
String Password = "xxxxxxxxxxxxxxxxxxxx";
String from = "xxxxx@xxxxx.com";
String toAddress = to;
Properties props = new Properties();
props.put("mail.transport.protocol", "smtp");
props.put("mail.host", host);
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.port", "587");
props.put("mail.smtp.starttls.enable", "true");
props.put("mail.smtp.ssl.trust", "*");

Session session = Session.getInstance(props, null);

MimeMessage message = new MimeMessage(session);
message.setFrom(new InternetAddress(from));
message.setRecipients(Message.RecipientType.TO, toAddress);
message.setSubject(sub);
BodyPart messageBodyPart = new MimeBodyPart();
messageBodyPart.setText(mes);
Multipart multipart = new MimeMultipart();
multipart.addBodyPart(messageBodyPart);
messageBodyPart = new MimeBodyPart();
DataSource source = new FileDataSource(filename);
messageBodyPart.setDataHandler(new DataHandler(source));
messageBodyPart.setFileName(name);
multipart.addBodyPart(messageBodyPart);
message.setContent(multipart);

try {
    Transport tr = session.getTransport("smtp");
    tr.connect(host, from, Password);
    tr.sendMessage(message, message.getAllRecipients());
    System.out.println("Mail Sent Successfully");
    tr.close();
} catch (SendFailedException sfe) {
    System.out.println(sfe);
}

排查步骤 #

1. 网络环境差异排查

• 验证SMTP服务器连通性：在目标机器执行telnet smtp.xxxxx.com 587或nc -zv smtp.xxxxx.com 587，检查是否能建立TCP连接。若失败，说明目标机器的防火墙、网络运营商或企业网关封禁了587端口，或SMTP服务器的IP无法访问。
• 检查代理设置：对比开发机与目标机的系统代理、Java代理配置。可在代码中临时添加System.out.println(System.getProperty("http.proxyHost"));、System.out.println(System.getProperty("https.proxyHost"));打印代理信息，确认目标机是否需要配置代理才能访问外部SMTP服务器。
• TLS/SSL连接验证：尽管代码设置了mail.smtp.ssl.trust=*，部分JRE版本对该配置的兼容性有限。目标机器的JRE可能缺少SMTP服务器的根证书，可尝试手动导入证书到目标机的jre/lib/security/cacerts证书库。

2. JRE环境差异排查

• 核对JRE版本：确认开发机使用的JDK/JRE版本与目标机一致（例如开发机用JDK11，目标机用JDK8可能存在JavaMail API兼容问题）。
• 检查JavaMail依赖打包：开发机因NetBeans自带JavaMail依赖可正常运行，但打包安装程序时需确保javax.mail.jar或jakarta.mail.jar被正确包含在安装包中，避免目标机因缺少依赖报错。
• JRE安全策略检查：对比开发机与目标机的jre/lib/security/java.policy文件，确认目标机的安全策略未限制程序的网络访问权限。

3. 文件权限与路径问题排查

• 附件路径验证：代码中的filename若为绝对路径，需确认目标机器存在该路径且程序有读取权限；若为相对路径，需确认程序运行时的工作目录与开发机一致，或改为基于程序安装目录的相对路径。
• 程序运行权限：目标机器运行程序的用户是否具备足够权限？例如是否被UAC限制（Windows）、是否为非管理员用户（Linux/macOS）导致无法访问网络或读取文件。

4. 邮件服务配置与认证排查

• SMTP服务器IP白名单：部分邮件服务商仅允许特定IP（如开发机公网IP）发送邮件，需确认目标机的公网IP是否在服务商的白名单内。
• 密码/授权码有效性：若代码中的Password是邮箱授权码，需确认目标机所在网络区域未触发服务商的异地登录限制；若为邮箱密码，需确认邮箱未开启二次验证或设备锁。
• Session认证配置优化：原代码中Session.getInstance(props, null)未传入自定义Authenticator，部分SMTP服务器需要明确的认证逻辑，可修改为：

Session session = Session.getInstance(props, new Authenticator() {
    @Override
    protected PasswordAuthentication getPasswordAuthentication() {
        return new PasswordAuthentication(from, Password);
    }
});

5. 日志与调试排查

• 扩展异常捕获：原代码仅捕获SendFailedException，需添加全局异常捕获并打印堆栈信息，明确错误类型：

try {
    // 发送邮件逻辑
} catch (SendFailedException sfe) {
    sfe.printStackTrace();
} catch (Exception e) {
    e.printStackTrace();
}

• 开启JavaMail调试模式：在Properties中添加props.put("mail.debug", "true");，打印SMTP通信的完整过程（包括握手、认证、命令交互），精准定位故障环节。

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