1. 概览与目标
1.1 适用场景与目标
在企业应用中，Java 应用程序经常需要通过 SMTP 发送通知、系统告警和报表邮件。本节聚焦如何通过 JavaMail 或 Jakarta Mail 实现这套流程，并明确从配置到代码实现的完整路径。
本指南强调在 安全性、可维护性与 可测试性之间取得平衡，涵盖最常用的 TLS/STARTTLS 以及 认证方式，确保在生产环境中的稳定性。
2. 环境准备与依赖
2.1 JDK 与库依赖
确保使用 JDK 8 及以上，以兼容最新的 javax.mail 或 jakarta.mail 库。
常见的依赖方式包括 Maven、Gradle。下面给出 Maven 的最小依赖示例，便于在项目中引入 JavaMail 功能。
com.sun.mail javax.mail 1.6.7
3. SMTP 配置与安全要点
3.1 服务器参数与安全
在应用中，SMTP 主机、端口、以及 认证是最基本的组成部分。通常 587 使用 STARTTLS，465 使用 SSL（SMTPS）。
通过 Properties 对象设定 mail.smtp.host、mail.smtp.port、mail.smtp.auth，以及开启 mail.smtp.starttls.enable。这些参数决定了连接的安全等级和行为。
mail.smtp.host=smtp.example.com
mail.smtp.port=587
mail.smtp.auth=true
mail.smtp.starttls.enable=true4. Java 实现：从配置到代码
4.1 核心发送流程
邮件发送的核心流程包括：准备 Properties、创建 Session、构建 MimeMessage、发送消息。在整个过程中，异常处理与 日志记录是保障可维护性的关键。
下面展示一个最小可运行的示例，展示如何利用 JavaMail 通过 SMTP 服务器发送文本邮件。
import javax.mail.*;
import javax.mail.internet.*;
import java.util.Properties;public class SimpleMailSender {public static void main(String[] args) throws Exception {final String username = "your_email@example.com";final String password = "your_password";Properties props = new Properties();props.put("mail.smtp.auth", "true");props.put("mail.smtp.starttls.enable", "true");props.put("mail.smtp.host", "smtp.example.com");props.put("mail.smtp.port", "587");Session session = Session.getInstance(props, new javax.mail.Authenticator() {@Overrideprotected PasswordAuthentication getPasswordAuthentication() {return new PasswordAuthentication(username, password);}});Message message = new MimeMessage(session);message.setFrom(new InternetAddress(username));message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com"));message.setSubject("测试邮件");message.setText("这是通过 JavaMail 发送的测试邮件。");Transport.send(message);System.out.println("邮件发送成功");}
}
4.2 完整示例：带 HTML 内容与附件
在实际场景中，邮件通常需要使用 HTML 内容，并附带一个或多个 附件。下列示例构建了一个 MimeMultipart 邮件，包含 HTML 正文和一个文本文件附件。
import javax.mail.*;
import javax.mail.internet.*;
import javax.activation.*;
import java.io.File;
import java.util.Properties;public class HtmlEmailWithAttachment {public static void main(String[] args) throws Exception {final String username = "your_email@example.com";final String password = "your_password";Properties props = new Properties();props.put("mail.smtp.auth", "true");props.put("mail.smtp.starttls.enable", "true");props.put("mail.smtp.host", "smtp.example.com");props.put("mail.smtp.port", "587");Session session = Session.getInstance(props, new javax.mail.Authenticator() {protected PasswordAuthentication getPasswordAuthentication() {return new PasswordAuthentication(username, password);}});Message message = new MimeMessage(session);message.setFrom(new InternetAddress(username));message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com"));message.setSubject("HTML 邮件示例");// HTML 内容MimeBodyPart htmlPart = new MimeBodyPart();String htmlContent = "这是一封 HTML 邮件示例。
";htmlPart.setContent(htmlContent, "text/html; charset=utf-8");// 附件MimeBodyPart attachmentPart = new MimeBodyPart();File file = new File("report.pdf"); // 确保文件存在DataSource source = new FileDataSource(file);attachmentPart.setDataHandler(new DataHandler(source));attachmentPart.setFileName(file.getName());// 组合成多部分Multipart multipart = new MimeMultipart();multipart.addBodyPart(htmlPart);multipart.addBodyPart(attachmentPart);message.setContent(multipart);Transport.send(message);System.out.println("HTML 邮件发送成功");}
}
5. 调试与排错
5.1 常用调试技巧
启动调试模式可以帮助你观察 SMTP 握手、认证流程以及 服务器响应。在创建 Session 时调用 session.setDebug(true)即可开启。
另外，检查常见错因，如 主机名或端口错误、用户名/密码错误，以及 防火墙和代理对 SMTP 的影响。对日志中的 442/530/535 等错误码要做逐条排查。
// 开启调试
Session session = Session.getInstance(props, authenticator);
session.setDebug(true);
6. 部署与性能优化
6.1 生产环境注意事项
在生产环境中，尽量使用 连接池或异步发送，以减少对主业务线程的阻塞；同时设置合理的 超时参数，如 mail.smtp.connectiontimeout、mail.smtp.timeout、以及 mail.smtp.writetimeout。
对邮件内容长度、图片引用以及附件大小进行控制，限制单封邮件大小以避免被对方服务器拒收；并且通过 错误重试与幂等性策略提升可靠性。
