一、环境准备与依赖配置
JDK版本与构建工具
在进行 Java 发送 邮件 的开发前，请确认 JDK 版本为 1.8 及以上，并选择构建工具（Maven 或 Gradle）以便管理依赖与构建过程。
此外，选择一个合适的集成开发环境（IDE）如 IntelliJ IDEA、Eclipse，可提升调试效率，帮助你快速定位问题、检查邮件相关的 API 调用链。
本阶段的目标是确保开发环境具备稳定的 JDK、构建工具和 IDE 支持，为后续的邮件发送功能打下基础。
邮件库依赖
在企业级场景中，JavaMail（javax.mail 或 jakarta.mail 的实现）是实现 邮件发送 的核心库，通常需要在项目中引入相应的依赖。
以下示例展示了常见的 Maven 配置。你可以根据目标平台选择 javax.mail 或 jakarta.mail 的版本。
<dependencies><dependency><groupId>com.sun.mail</groupId><artifactId>javax.mail</artifactId><version>1.6.2</version></dependency>
</dependencies>
如果你使用 Gradle，可以换成等效的实现定义，确保构建阶段能正确解析邮件库并在运行时加载。
完整教程与代码示例：从配置到实战，企业级场景也适用，在后续章节中将逐步落地到实战代码与配置细节，帮助你快速落地实施。
二、配置 JavaMail 与 SMTP
SMTP 配置与身份认证
实现 Java 发送 邮件 的第一步是明确 SMTP 服务器的参数，包括主机、端口、是否使用 TLS/SSL 以及认证信息。SMTP 是邮件传输的核心协议，常见端口为 587（STARTTLS）和 465（SSL/TLS）。
在企业场景中，建议使用带认证的 SMTP 服务，并对账号设置最小权限，确保凭据不会泄露给无关系统。
通过配置文件或环境变量提供凭证，有助于实现凭证分离与轮换，从而提升整体安全性。
会话属性与授权信息
通过 Session 对象来封装 Properties 与认证信息，形成可复用的邮件发送会话。
import java.util.Properties;
import javax.mail.PasswordAuthentication;
import javax.mail.Session;public class MailSessionFactory {public static Session createSession(String username, String password, String host, int port) {Properties props = new Properties();props.put("mail.smtp.auth", "true");props.put("mail.smtp.starttls.enable", "true");props.put("mail.smtp.host", host);props.put("mail.smtp.port", String.valueOf(port));return Session.getInstance(props, new javax.mail.Authenticator() {protected PasswordAuthentication getPasswordAuthentication() {return new PasswordAuthentication(username, password);}});}
}
通过这段代码，你可以得到一个带认证信息的 Session 对象，后续即可用于发送邮件的流程中。
三、完整发送流程实战案例
构建邮件内容
邮件内容可以包含纯文本、HTML 内容以及附件等多种形式。MimeMessage 是邮件的载体，MimeMultipart 用于将文本、HTML 与附件组合起来，形成完整的邮件体。
在企业应用中，通常会构建一个通用的邮件构建器，用来根据模板生成最终邮件内容，从而实现个性化与模块化的组合。
import javax.mail.*;
import javax.mail.internet.*;
import java.util.Date;public class EmailSender {private Session session;public EmailSender(Session session) { this.session = session; }public void send(String from, String to, String subject, String htmlContent) throws MessagingException {MimeMessage message = new MimeMessage(session);message.setFrom(new InternetAddress(from));message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to));message.setSubject(subject, "UTF-8");MimeBodyPart htmlPart = new MimeBodyPart();htmlPart.setContent(htmlContent, "text/html; charset=UTF-8");MimeMultipart multipart = new MimeMultipart("alternative");multipart.addBodyPart(htmlPart);message.setContent(multipart);message.setSentDate(new Date());Transport.send(message);}
}
该实现展示了如何用 MimeMessage 搭配 MimeMultipart 构造包含 HTML 内容的邮件，并通过 Transport.send 实现发送。
发送与异常处理
企业级应用中，邮件发送需要考虑失败重试、幂等性、超时等因素，因此应包含健壮的异常处理与日志记录。
通过封装服务层，可以在发送失败时执行重试策略、记录错误并触发告警，确保业务流程的可观测性与鲁棒性。
import javax.mail.MessagingException;public class EmailService {private final EmailSender sender;public EmailService(EmailSender sender) { this.sender = sender; }public void safeSend(String from, String to, String subject, String html) {try {sender.send(from, to, subject, html);} catch (MessagingException e) {// 记录日志、重试策略、告警通知throw new RuntimeException("邮件发送失败: " + e.getMessage(), e);}}
}
四、企业级场景的扩展与最佳实践
安全与凭证管理
在企业级场景中，凭证管理需要通过安全的方式存储，如配置中心、密钥库、环境变量等，避免将明文凭据写入代码或仓库。
推荐使用 OAuth2、应用专用密码或一次性令牌等机制，以降低凭证泄露风险，并实施轮换策略与访问控制。
并发发送与队列
高并发或大规模发送场景，建议引入异步处理，通过队列将邮件任务解耦，提升系统吞吐量与响应速度。
实现方式包括使用线程池、消息队列（如 Kafka、RabbitMQ）或任务调度器，确保发送任务在后台顺利执行，同时防止阻塞主业务流程。
import java.util.concurrent.*;public class EmailQueueDispatcher {private final ExecutorService executor = Executors.newFixedThreadPool(4);private final EmailSender sender;public EmailQueueDispatcher(EmailSender sender) { this.sender = sender; }public void enqueue(EmailTask task) {executor.submit(() -> {try {sender.send(task.from, task.to, task.subject, task.html);} catch (Exception e) {// 处理失败，如重试、告警、持久化失败记录}});}
}
class EmailTask {String from, to, subject, html;
}
邮件模板与跟踪
使用模板引擎生成动态内容，例如 FreeMarker、Handlebars，结合占位符实现个性化邮件，可提升用户体验与转化率。
// 伪代码：用 FreeMarker 渲染 HTML 模板
// Template template = cfg.getTemplate("welcome.ftlh");
// Map<String, Object> data = new HashMap<>(); data.put("name", userName);
// String html = FreeMarkerTemplateUtils.processTemplateIntoString(template, data);
五、常见问题与排错
认证失败 (535) / 连接超时
常见原因包括 用户名/密码错误、TLS/SSL 配置、以及防火墙阻断端口等。确保凭证与端口设置正确，且服务器允许所用客户端进行认证。
开启邮件调试模式，有助于定位问题的具体阶段，例如 Connection、Authentication、TLS 握手 的错误信息。
// 启用调试
Properties props = new Properties();
props.put("mail.debug", "true");
Session session = Session.getInstance(props, authenticator);
邮件被标记为垃圾邮件
若发送的邮件频繁被识别为垃圾邮件，需要对域名进行 SPF/DKIM/DMARC 配置，并确保使用可信的 SMTP 服务商，避免被对方邮件系统误判。
此外，邮件内容的结构、链接、图片资源等也需遵循反垃圾邮件的最佳实践。
