1. JavaMail 技术概览JavaMail 是 Java 平台处理电子邮件的标准 API它提供了一套与协议无关的邮件系统访问框架。这个 API 最早作为 Java EE 的一部分出现后来也作为可选包支持 Java SE 平台。在实际开发中我经常用它来处理各种邮件相关的业务场景比如发送验证码、系统通知、批量营销邮件等。提示虽然 JavaMail 1.6.2 是当前稳定版本但需要注意该项目已迁移至 Eclipse 基金会后续更新将由 Eclipse Enterprise for Java (EE4J) 项目维护。核心功能上JavaMail 支持 SMTP发送邮件、POP3 和 IMAP接收邮件等主流协议。特别值得一提的是它对协议抽象的设计——无论底层使用哪种邮件协议上层 API 调用方式基本一致。这种设计让代码在不同邮件服务间迁移时几乎不需要修改业务逻辑。2. 环境配置与基础使用2.1 依赖引入方式现代 Java 项目通常通过 Maven 管理依赖。以下是当前最新版1.6.2的配置dependency groupIdcom.sun.mail/groupId artifactIdjavax.mail/artifactId version1.6.2/version /dependency如果只需要 API 定义比如开发库项目可以使用javax.mail-api工件并设置provided作用域dependency groupIdjavax.mail/groupId artifactIdjavax.mail-api/artifactId version1.6.2/version scopeprovided/scope /dependency2.2 基础发送示例下面是一个发送纯文本邮件的完整示例包含了我实际项目中总结的最佳实践import java.util.Properties; import javax.mail.*; import javax.mail.internet.*; public class BasicMailSender { public static void send(String to, String from, String host, String subject, String text) throws MessagingException { // 1. 配置属性 Properties props new Properties(); props.put(mail.smtp.host, host); props.put(mail.smtp.port, 587); props.put(mail.smtp.auth, true); props.put(mail.smtp.starttls.enable, true); // TLS加密 // 2. 创建认证器 Authenticator auth new Authenticator() { protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(username, password); } }; // 3. 获取会话 Session session Session.getInstance(props, auth); try { // 4. 构建消息 Message message new MimeMessage(session); message.setFrom(new InternetAddress(from)); message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to)); message.setSubject(subject); message.setText(text); // 5. 发送 Transport.send(message); System.out.println(邮件发送成功); } catch (MessagingException e) { throw new RuntimeException(邮件发送失败, e); } } }注意生产环境中密码不应硬编码在代码中建议通过环境变量或配置中心获取。同时建议配置连接超时参数props.put(mail.smtp.connectiontimeout, 5000); // 5秒连接超时 props.put(mail.smtp.timeout, 10000); // 10秒IO超时3. 高级功能实现3.1 发送HTML与附件实际业务中经常需要发送带格式的邮件和附件。以下示例展示如何发送包含HTML内容和PDF附件的邮件public class AdvancedMailSender { public static void sendHtmlWithAttachment(String to, String subject) throws MessagingException { Properties props new Properties(); props.put(mail.smtp.host, smtp.example.com); Session session Session.getInstance(props); MimeMessage message new MimeMessage(session); message.setFrom(new InternetAddress(no-replyexample.com)); message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to)); message.setSubject(subject); // 创建多部分消息 MimeMultipart multipart new MimeMultipart(); // HTML正文部分 MimeBodyPart htmlPart new MimeBodyPart(); String htmlContent h1重要通知/h1p您的账单已生成请查看附件/p; htmlPart.setContent(htmlContent, text/html; charsetutf-8); multipart.addBodyPart(htmlPart); // 附件部分 MimeBodyPart attachPart new MimeBodyPart(); attachPart.attachFile(new File(invoice.pdf)); attachPart.setFileName(月度账单.pdf); multipart.addBodyPart(attachPart); message.setContent(multipart); Transport.send(message); } }3.2 接收邮件处理JavaMail 接收邮件主要使用 Store 和 Folder 类。以下是读取收件箱最新10封邮件的示例public class MailReceiver { public static void checkInbox(String host, String user, String password) { Properties props new Properties(); props.put(mail.store.protocol, imaps); // 使用IMAP协议 Session session Session.getInstance(props); try { // 连接邮件服务器 Store store session.getStore(); store.connect(host, user, password); // 打开收件箱 Folder inbox store.getFolder(INBOX); inbox.open(Folder.READ_ONLY); // 获取最新10封邮件 Message[] messages inbox.getMessages( Math.max(1, inbox.getMessageCount() - 9), inbox.getMessageCount() ); for (Message message : messages) { System.out.println(主题: message.getSubject()); System.out.println(发件人: Arrays.toString(message.getFrom())); System.out.println(日期: message.getSentDate()); // 获取纯文本内容 if (message.isMimeType(text/plain)) { System.out.println(内容: message.getContent()); } } inbox.close(false); store.close(); } catch (Exception e) { e.printStackTrace(); } } }4. 生产环境最佳实践4.1 连接池配置高并发场景下频繁创建邮件会话会导致性能问题。建议使用连接池管理邮件会话import org.apache.commons.pool2.impl.GenericObjectPool; public class MailSessionPool { private static GenericObjectPoolSession pool; static { Properties props new Properties(); props.put(mail.smtp.host, smtp.example.com); props.put(mail.smtp.port, 587); pool new GenericObjectPool(new BasePooledObjectFactorySession() { Override public Session create() { return Session.getInstance(props); } Override public PooledObjectSession wrap(Session session) { return new DefaultPooledObject(session); } }); pool.setMaxTotal(20); // 最大连接数 pool.setMaxIdle(10); // 最大空闲连接 } public static Session getSession() throws Exception { return pool.borrowObject(); } public static void returnSession(Session session) { pool.returnObject(session); } }4.2 异常处理策略邮件发送可能遇到各种异常需要合理的重试机制public class RobustMailSender { private static final int MAX_RETRIES 3; public static void sendWithRetry(Message message) { int attempt 0; while (attempt MAX_RETRIES) { try { Transport.send(message); return; } catch (MessagingException e) { attempt; if (attempt MAX_RETRIES) { throw new RuntimeException(邮件发送失败, e); } try { Thread.sleep(1000 * attempt); // 指数退避 } catch (InterruptedException ie) { Thread.currentThread().interrupt(); throw new RuntimeException(发送中断, ie); } } } } }4.3 安全配置建议SSL/TLS配置props.put(mail.smtp.ssl.enable, true); props.put(mail.smtp.ssl.checkserveridentity, true); // 验证服务器证书 props.put(mail.smtp.ssl.trust, smtp.example.com); // 只信任指定主机NTLM认证 对于企业内网Exchange服务器可能需要NTLM认证props.put(mail.smtp.auth.ntlm.domain, DOMAIN);OAuth2支持 新版支持通过OAuth2认证如Gmailprops.put(mail.smtp.auth.mechanisms, XOAUTH2); props.put(mail.smtp.sasl.enable, true); props.put(mail.smtp.sasl.mechanisms, XOAUTH2); props.put(mail.smtp.auth.xoauth2.disable, false);5. 常见问题排查5.1 连接超时问题典型错误javax.mail.MessagingException: Could not connect to SMTP host排查步骤检查网络连通性telnet smtp.example.com 587验证防火墙设置检查JavaMail超时配置props.put(mail.smtp.connectiontimeout, 10000); props.put(mail.smtp.timeout, 30000);5.2 认证失败问题错误示例javax.mail.AuthenticationFailedException: 535 Authentication credentials invalid解决方案确认用户名密码正确检查是否需要应用专用密码如Gmail两步验证尝试在邮件服务网页端登录验证账号状态5.3 附件大小限制大多数邮件服务器对附件有大小限制通常25MB左右。处理大附件时使用云存储链接替代直接附件分卷压缩大文件配置服务器参数props.put(mail.smtp.sendpartial, true);6. 协议扩展与定制6.1 自定义协议提供者JavaMail 支持通过 SPI 机制扩展协议。创建自定义提供者的基本步骤实现javax.mail.Providerpublic class MyProtocolProvider extends Provider { public MyProtocolProvider() { super(Provider.Type.STORE, myproto, com.example.MyProtocolStore, Vendor, 1.0); } }在META-INF/services/javax.mail.Provider文件中注册com.example.MyProtocolProvider使用时指定协议props.put(mail.store.protocol, myproto);6.2 Gmail特殊支持JavaMail 提供对 Gmail 的特别支持通过gimap协议// 接收邮件 props.put(mail.store.protocol, gimap); props.put(mail.gimap.socketFactory.class, javax.net.ssl.SSLSocketFactory); props.put(mail.gimap.socketFactory.fallback, false); props.put(mail.gimap.ssl.enable, true);7. 性能优化技巧会话复用创建 Session 对象开销较大应尽量复用批量发送使用Transport.sendMessages()批量发送异步处理将邮件发送放入线程池ExecutorService executor Executors.newFixedThreadPool(5); executor.submit(() - { try { Transport.send(message); } catch (MessagingException e) { // 处理异常 } });DNS缓存配置JVM的DNS缓存时间减少DNS查询-Dsun.net.inetaddr.ttl608. 测试策略8.1 单元测试使用 GreenMail 进行本地测试Before public void setup() { GreenMail greenMail new GreenMail(); greenMail.start(); } Test public void testSendMail() throws Exception { // 发送测试邮件 sendTestMessage(); // 验证邮件 MimeMessage[] messages greenMail.getReceivedMessages(); assertEquals(1, messages.length); assertEquals(Test Subject, messages[0].getSubject()); } After public void tearDown() { greenMail.stop(); }8.2 集成测试要点测试各种邮件服务器Exchange, Gmail, 网易等模拟网络异常测试重试机制验证不同编码特别是中文的显示正确性测试大附件和特殊格式附件9. 日志与监控建议配置 JavaMail 的调试日志props.put(mail.debug, true);生产环境推荐使用 SLF4J 桥接添加依赖dependency groupIdorg.slf4j/groupId artifactIdslf4j-jdk14/artifactId version1.7.36/version /dependency配置日志级别# logback.xml logger namejavax.mail levelDEBUG/关键监控指标发送成功率平均发送延迟重试次数分布各邮件服务器响应时间10. 替代方案比较虽然 JavaMail 是标准方案但在某些场景下可以考虑方案优点缺点适用场景JavaMail标准、功能全面配置复杂、API略陈旧需要全面控制的企业应用Spring Email简化API、与Spring集成功能较少Spring项目简单需求Apache Commons Email简单易用功能有限快速开发小型应用第三方SDK如AWS SES高可靠性、扩展服务厂商锁定、成本云原生应用实际项目中我通常会根据团队技术栈选择Spring项目用Spring Email传统JavaEE用JavaMail云服务优先考虑厂商SDK。