Java Mail发邮件指南：从配置到实战Java Mail是Java平台处理电子邮件的核心API，在开发邮件发送功能时扮演着重要角色。我们这篇文章将详细介绍Java Mail发送邮件的完整流程，包括环境配置、代码实现、常见问题及优化建议

Java Mail发邮件指南：从配置到实战

Java Mail是Java平台处理电子邮件的核心API，在开发邮件发送功能时扮演着重要角色。我们这篇文章将详细介绍Java Mail发送邮件的完整流程，包括环境配置、代码实现、常见问题及优化建议。主要内容包括：Java Mail基本概念；发送邮件前的准备工作；基础邮件发送代码实现；带附件的邮件发送；HTML格式邮件发送；常见问题与解决方法；安全性与性能优化建议。

一、Java Mail基本概念

Java Mail API是Sun公司提供的一套标准扩展库，用于读取、撰写和发送电子邮件。该API支持SMTP、POP3和IMAP协议，其核心类主要位于javax.mail和javax.mail.internet包中。

使用时需注意：
1. 需要JavaMail API的jar包（如javax.mail.jar）
2. Java 6及以后版本需要单独下载该库
3. 最新的Jakarta Mail是JavaMail的继任者，适用于Java EE 8及以上

二、发送邮件前的准备工作

在实际开发前，需要完成以下配置：

1. 获取SMTP服务器信息

常见邮件服务商SMTP配置：

服务商	SMTP服务器	端口	加密方式
QQ邮箱	smtp.qq.com	465/587	SSL/TLS
163邮箱	smtp.163.com	465	SSL
Gmail	smtp.gmail.com	587	TLS

2. 开启SMTP服务

以QQ邮箱为例：
1. 登录网页版QQ邮箱
2. 进入"设置"→"账户"
3. 开启"POP3/SMTP服务"
4. 获取授权码（替代密码使用）

三、基础邮件发送代码实现

// 基本邮件发送示例
Properties props = new Properties();
props.put("mail.smtp.host", "smtp.qq.com"); // SMTP服务器地址
props.put("mail.smtp.port", "465"); // 端口号
props.put("mail.smtp.auth", "true"); // 需要认证
props.put("mail.smtp.ssl.enable", "true"); // 启用SSL加密

// 创建会话
Session session = Session.getInstance(props, new Authenticator() {
    protected PasswordAuthentication getPasswordAuthentication() {
        return new PasswordAuthentication("发件人邮箱", "授权码");
    }
});

try {
    // 创建邮件对象
    MimeMessage message = new MimeMessage(session);
    message.setFrom(new InternetAddress("发件人邮箱"));
    message.setRecipient(Message.RecipientType.TO, 
        new InternetAddress("收件人邮箱"));
    message.setSubject("测试邮件主题");
    message.setText("这是一封测试邮件的正文内容");

    // 发送邮件
    Transport.send(message);
    System.out.println("邮件发送成功");
} catch (MessagingException e) {
    e.printStackTrace();
}

四、带附件的邮件发送

实现附件发送需要使用MimeMultipart和MimeBodyPart类：

// 创建复合邮件内容
Multipart multipart = new MimeMultipart();

// 添加正文部分
BodyPart messageBodyPart = new MimeBodyPart();
messageBodyPart.setText("这是带附件的邮件正文");
multipart.addBodyPart(messageBodyPart);

// 添加附件部分
messageBodyPart = new MimeBodyPart();
DataSource source = new FileDataSource("test.pdf");
messageBodyPart.setDataHandler(new DataHandler(source));
messageBodyPart.setFileName("测试文件.pdf");
multipart.addBodyPart(messageBodyPart);

// 设置邮件内容
message.setContent(multipart);

五、HTML格式邮件发送

发送HTML邮件需要设置内容类型：

String htmlContent = "<h1>HTML邮件</h1><p>这是<b>加粗</b>文本</p>";
message.setContent(htmlContent, "text/html;charset=UTF-8");

包含内嵌图片的HTML邮件：

Multipart multipart = new MimeMultipart("related");

// HTML正文部分
BodyPart htmlPart = new MimeBodyPart();
String htmlBody = "<img src='cid:image1'>";
htmlPart.setContent(htmlBody, "text/html");
multipart.addBodyPart(htmlPart);

// 图片部分
BodyPart imagePart = new MimeBodyPart();
DataSource fds = new FileDataSource("logo.png");
imagePart.setDataHandler(new DataHandler(fds));
imagePart.setHeader("Content-ID", "<image1>");
multipart.addBodyPart(imagePart);

六、常见问题与解决方法

1. 认证失败问题

错误现象：javax.mail.AuthenticationFailedException
解决方案：
• 确认用户名/密码正确（注意使用授权码而非邮箱密码）
• 检查SMTP服务是否已开启
• 尝试关闭防火墙或安全软件测试

2. 连接超时问题

错误现象：javax.mail.MessagingException: Could not connect to SMTP host
解决方案：
• 确认网络连接正常
• 检查SMTP服务器地址和端口是否正确
• 测试telnet服务器端口是否可达

3. 邮件发送缓慢

优化建议：
• 重用Session对象（避免为每封邮件创建新Session）
• 对于批量邮件，使用单独的发送线程
• 考虑异步发送机制

七、安全性与性能优化建议

安全建议

1. 不要在代码中硬编码邮箱密码，使用配置中心或环境变量
2. 优先使用OAuth2.0认证（如Gmail API）
3. 启用STARTTLS加密连接
4. 限制邮件发送频率防止被判定为垃圾邮件

性能优化

1. 使用连接池管理SMTP连接
2. 大附件建议先压缩再发送
3. 超时设置：

props.put("mail.smtp.connectiontimeout", "5000");
props.put("mail.smtp.timeout", "5000");

4. 考虑使用消息队列实现异步邮件发送

行业最佳实践

1. 邮件服务独立化：将邮件服务拆分为独立微服务
2. 邮件模板管理：使用模板引擎动态生成邮件内容
3. 发送记录追踪：记录每封邮件的发送状态和打开情况
4. 支持退订功能：遵守反垃圾邮件法规