NetBeans内可正常发带附件邮件，导出Jar实例化MultiPartEmail时无响应

问题详情 #

在NetBeans开发环境中，通过Gmail发送带附件的邮件功能正常，但导出为Jar文件运行时，程序卡在MultiPartEmail email = new MultiPartEmail();这一行——既不弹出显示数字3的对话框，也不抛出异常，后续代码完全无法执行。尝试切换到javax-mail.jar也遇到相同问题：仅NetBeans内运行正常，Jar文件无法完成邮件发送流程。

完整代码 #

package FTPEmail;

import org.apache.commons.mail.DefaultAuthenticator;
import org.apache.commons.mail.EmailAttachment;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.MultiPartEmail;

import java.io.IOException;

public class SendAttachment {

public SendAttachment(String attachment, String subject, String msg) throws IOException {
    final String sender = "sender123@gmail.com";
    final String receiver = "receiver123@gmail.com";
    final String password = "abc123abc123abc1";
    Tools.Text.dialogErrorNumber("1");
    try {
        EmailAttachment emailAttachment = new EmailAttachment();
        emailAttachment.setPath(attachment);
        emailAttachment.setDisposition(EmailAttachment.ATTACHMENT);
        emailAttachment.setDescription("Attachment");
        Tools.Text.dialogErrorNumber("2");
        MultiPartEmail email = new MultiPartEmail();
        Tools.Text.dialogErrorNumber("3");
        email.setHostName("smtp.gmail.com");
        Tools.Text.dialogErrorNumber("4");
        email.setSmtpPort(465);
        Tools.Text.dialogErrorNumber("5");
        email.setAuthenticator(new DefaultAuthenticator(sender, password));
        Tools.Text.dialogErrorNumber("6");
        email.setSSLOnConnect(true);
        Tools.Text.dialogErrorNumber("7");
        email.addTo(receiver);
        Tools.Text.dialogErrorNumber("8");
        email.setFrom(sender);
        Tools.Text.dialogErrorNumber("9");
        email.setSubject(subject);
        Tools.Text.dialogErrorNumber("10");
        email.setMsg(msg);
        Tools.Text.dialogErrorNumber("11");

        // attach the file
        email.attach(emailAttachment);
        Tools.Text.dialogErrorNumber("12");
        // send the email
        email.send();
    } catch (EmailException e) {
        Tools.Text.dialogErrorNumber(e.getMessage());
        Tools.Text.dialogErrorNumber("0060");
    }
}
}

解决办法 #

1. 确保依赖完全打包 #

NetBeans默认导出Jar时可能只包含项目自身代码，未将commons-mail、javax.mail等依赖库一并打包。重新导出时：

• 选择“导出可执行Jar”
• 在向导中勾选**“将所需库打包到生成的Jar中”或“将所需库复制到生成的Jar旁的子文件夹”**
• 确认所有依赖的.jar文件都被包含在最终的运行包中

2. 替换对话框日志为控制台输出 #

Jar运行时可能因UI环境限制导致对话框无法弹出，掩盖了真实错误。把Tools.Text.dialogErrorNumber("xxx")替换为System.out.println("xxx")，然后用命令行执行Jar：

java -jar your-jar-file.jar

查看控制台输出，定位是类加载失败、资源缺失还是其他阻塞问题。

3. 修正Gmail认证配置 #

• 如果账号开启了两步验证：必须使用应用专用密码（Google账号设置→安全→应用专用密码）代替原密码
• 未开启两步验证：确保账号允许“低权限应用访问”（Google账号设置→安全→低权限应用访问）

4. 解决SSL证书信任问题 #

MultiPartEmail初始化时需要加载SSL证书，Jar运行时可能找不到系统默认信任库。可通过JVM参数指定：

java -Djavax.net.ssl.trustStore=$JAVA_HOME/jre/lib/security/cacerts -Djavax.net.ssl.trustStorePassword=changeit -jar your-jar-file.jar

若使用自定义证书，可将证书打包到Jar中，并实现自定义信任管理器加载。

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