JavaMail项目在NetBeans中运行正常，打包为可执行JAR后无法发邮件

问题描述 #

项目在NetBeans开发环境中运行时能正常发送邮件，但打包成可执行JAR直接运行（包括在其他电脑/服务器上）时，JOptionPane提示“发送成功”，但收件人实际未收到邮件。

相关代码 #

public static void sendMail(String recepient) throws Exception{
    System.out.println("Preaparing to send Email");
    Properties properties = new Properties();

    properties.put("mail.smtp.auth", "true");
    properties.put("mail.smtp.starttls.enable", "false");
    properties.put("mail.smtp.host", "mail.xyz.in");
    properties.put("mail.smtp.port", "587");

    final String myAccountEmail = Sender;
    final String password = email_pass;

    Session session = Session.getInstance(properties, new Authenticator(){
        @Override
        protected PasswordAuthentication getPasswordAuthentication(){
            return new PasswordAuthentication(myAccountEmail, password);
        }
    });

    Message message = prepareMessage(session,myAccountEmail,recepient);

    Transport.send(message);
    System.out.println("Message Send Successful");
    JOptionPane.showMessageDialog(null, "Successful");
}

private static Message prepareMessage(Session session,String myAccountEmail, String recepient) {
    try{
        MimeMessage message = new MimeMessage(session);
        message.setFrom(new InternetAddress(myAccountEmail));
        message.setRecipient(Message.RecipientType.TO, new InternetAddress(recepient));
        message.setSubject(sub);

        BodyPart messageBodyPart1 = new MimeBodyPart();
        messageBodyPart1.setText(msg);

        Multipart multipartObject = new MimeMultipart();
        multipartObject.addBodyPart(messageBodyPart1);

        message.setContent(multipartObject);
        return message;
    }
    catch(Exception e){
        JOptionPane.showMessageDialog(null, e.toString());
        e.printStackTrace();
    }
    return null;
}

项目结构 #

排查方向与解决方案 #

1. 依赖包缺失 #

NetBeans运行时会自动加载项目依赖，但打包JAR时如果未将JavaMail相关依赖（如javax.mail.jar、activation.jar）一同打包，会导致运行时发送逻辑异常。

• 操作：在NetBeans的项目属性→打包→库和资源中，勾选所有JavaMail相关依赖，生成包含依赖的完整JAR；若用Maven/Gradle，配置Shade等插件将依赖打进JAR。

2. SMTP配置不匹配 #

当前配置mail.smtp.starttls.enable=false但使用587端口，而587端口通常要求STARTTLS加密，不同环境的SMTP服务器对加密规则要求不同。

• 尝试调整配置：

  // 开启STARTTLS适配587端口
  properties.put("mail.smtp.starttls.enable", "true");
  // 或改用SSL加密的465端口
  properties.put("mail.smtp.ssl.enable", "true");
  properties.put("mail.smtp.port", "465");
  

• 同时确认Sender、email_pass等变量在打包后能正确取值，若来自配置文件，需确保配置文件被打进JAR且读取路径正确。

3. 邮件被拦截 #

开发环境与JAR运行环境的发件IP不同，邮件可能被收件人邮箱判定为垃圾邮件，进入垃圾箱。

• 操作：检查收件人垃圾邮件文件夹；联系SMTP服务器提供商确认发件IP是否在黑名单中。

4. 异常被隐藏 #

sendMail方法中Transport.send(message)抛出的异常未被捕获，若调用该方法的代码吞了异常，会导致错误提示缺失。

• 修改代码添加异常捕获：

  try {
      Transport.send(message);
      System.out.println("Message Send Successful");
      JOptionPane.showMessageDialog(null, "Successful");
  } catch (Exception e) {
      JOptionPane.showMessageDialog(null, "发送失败：" + e.toString());
      e.printStackTrace();
  }
  

5. 资源文件未正确打包 #

从项目结构截图看，若sub、msg等变量来自外部资源文件，需确认资源文件被正确打包进JAR的classpath路径下，避免运行时无法读取。

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