JavaMail API 是 Oracle 提供的邮件协议抽象层，现已被 Jakarta Mail 取代；推荐使用 Spring 的 JavaMailSender 或 Simple Java Mail 等封装方案以避免底层配置错误。
JavaMail API 是什么，现在还该用吗
JavaMail API 是 Oracle 提供的官方邮件协议抽象层（javax.mail），底层封装了 SMTP/POP3/IMAP 协议交互逻辑。但它本身不实现网络通信，必须搭配具体 Provider（如 smtp.jar）才能工作。从 Java EE 7 开始，它已从 JDK 中移除；Java 11+ 完全不包含，需手动引入依赖。
如果你在用 Spring Boot，spring-boot-starter-mail 底层默认仍基于 JavaMail API（使用 jakarta.mail 迁移版），但屏蔽了大部分底层细节。纯 Java SE 项目若还要手写 Session、MimeMessage、Transport.send()，容易出编码、认证、SSL/TLS 配置错误——这不是 API 设计问题，而是协议细节太琐碎。
- Java 8–10：可用
javax.mail:javax.mail-api+com.sun.mail:javax.mail - Java 11+：必须用 Jakarta EE 版本：
jakarta.mail:jakarta.mail-api和org.eclipse.angus:angus-mail（原 GlassFish Mail 的继任者） - Spring Boot 3.x 已全面切换到
jakarta.mail，直接依赖spring-boot-starter-mail即可，无需再管类名迁移
为什么推荐 Spring Framework 的 JavaMailSender 而非裸用 JavaMail API
裸调 JavaMail API 写一封带附件的 HTML 邮件，要处理 MIME 类型、字符集、Base64 编码、边界分隔符、Content-ID 引用……稍有不慎就出现乱码、附件打不开、图片不显示。而 JavaMailSender 把这些封装成声明式操作，错误集中在配置阶段（比如 mail.smtp.auth=true 忘设），而非运行时难调试的字节流问题。
关键差异点：
立即学习“Java免费学习笔记（深入）”；
AlegroCart新功能：维类：包括在这两种线性长宽高或面积或体积长波产品尺寸允许与期权产品：让产品/期权组合独特的数量，尺寸，图像和型号。选择店铺标识管理 图片放大镜：显示一个图片放大上空盘旋时，产品形象弹出框。自定义错误报告：设置在管理员启用。 开发者只可以显示详细的信息。错误信息都写入到错误日志文件每天可以通过电子邮件发送给管理员。仓库皮卡航运模块：允许客户指定产品在商店的位置回升。增加了
-
JavaMailSender是接口，Spring 默认实现是JavaMailSenderImpl，它自动适配jakarta.mail.Session，且支持连接池（通过setSession()复用） - 发送方法统一为
send(MimeMessagePreparator)或send(SimpleMailMessage)，避免手动 newMimeMessage和 setFrom/setRecipients 等易错链式调用 - 异常类型更明确：
MailAuthenticationException、MailSendException直接对应问题根源，不像裸 API 只抛javax.mail.AuthenticationFailedException或底层IOException
SimpleMailMessage message = new SimpleMailMessage();
message.setFrom("no-reply@example.com");
message.setTo("user@test.com");
message.setSubject("订单确认");
message.setText("您的订单已提交，预计24小时内发货。");
javaMailSender.send(message);
常见失败场景与对应配置项
90% 的邮件发送失败不是代码问题，而是 SMTP 配置与服务商策略不匹配。以下是真实高频报错及解法：
-
javax.mail.AuthenticationFailedException：检查mail.smtp.auth是否为true，且用户名密码是否为应用专用密码（如 Gmail 开启两步验证后需用 App Password，而非账户登录密码） -
Could not convert socket to TLS：说明服务器要求 STARTTLS，但代码用了mail.smtp.ssl.enable=true（这是 SSL/TLS 直连，端口通常是 465）。应改用mail.smtp.starttls.enable=true+ 端口 587 - 中文主题/正文乱码：确保
mail.mime.charset=UTF-8，且SimpleMailMessage不支持 HTML，要用MimeMessagePreparator并显式设置message.setContent(..., "text/html;charset=UTF-8") - 被 Gmail/Outlook 当垃圾邮件：发件人地址必须真实存在且经过 SPF/DKIM/DMARC 验证；避免纯 HTML、过多链接、敏感词；测试时先用公司域名邮箱，别用免费邮箱直连
轻量替代方案：Simple Java Mail
如果项目不用 Spring，又嫌 Jakarta Mail 配置太重，Simple Java Mail 是个务实选择。它本质是 JavaMail API 的 fluent 封装，不引入新协议栈，但把所有配置、MIME 构建、异常映射都收拢到一个入口。
优势在于零配置启动（内置主流邮箱默认值）、一行代码发 HTML+附件、支持异步发送、自带日志开关。它内部仍用 jakarta.mail，所以 Java 17+ 兼容性无压力。
Mailer mailer = MailerBuilder
.withSMTPServer("smtp.gmail.com", 587, "you@gmail.com", "app-password")
.buildMailer();
Email email = EmailBuilder.startingBlank()
.from("Me", "me@example.com")
.to("You", "you@example.com")
.withSubject("Test")
.withPlainText("Hi there!")
.withHTMLText("Hi there!
")
.buildEmail();
mailer.sendMail(email);
注意：它的 Mailer 实例是线程安全的，可单例复用；但不要在高并发下频繁 new Email 对象而不复用 EmailBuilder，否则 GC 压力会上升。
