Javamail API如何使用

JavaMail API 是 Java EE 平台中用于发送和接收电子邮件的核心库，支持 SMTP、POP3、IMAP 等协议，以下为详细使用指南，遵循安全性和最佳实践：

环境准备

1. 添加依赖（以最新版 Jakarta Mail 2.1.0 为例）：

   

   <!-- Maven 依赖 --> <dependency> <groupId>org.eclipse.angus</groupId> <artifactId>angus-mail</artifactId> <version>2.0.3</version> <!-- 2025年更新 --> </dependency>

2. 启用邮箱服务：

   • 在邮箱设置中开启 SMTP/POP3/IMAP 服务（如 QQ 邮箱需生成授权码代替密码）。

核心对象解析

发送邮件（SMTP）

import jakarta.mail.*; import jakarta.mail.internet.*; public class MailSender { public static void main(String[] args) { // 1. 配置会话 Properties props = new Properties(); props.put("mail.smtp.host", "smtp.qq.com"); // SMTP服务器 props.put("mail.smtp.port", "587"); // TLS端口 props.put("mail.smtp.auth", "true"); // 启用认证 props.put("mail.smtp.starttls.enable", "true"); // 加密传输 Session session = Session.getInstance(props, new Authenticator() { @Override protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication("your_email@qq.com", "授权码"); // 替换为实际值 } }); try { // 2. 构建邮件 Message message = new MimeMessage(session); message.setFrom(new InternetAddress("your_email@qq.com")); message.setRecipient(Message.RecipientType.TO, new InternetAddress("recipient@example.com")); message.setSubject("测试邮件主题"); // 3. 设置内容（支持HTML） String htmlContent = "<h1>Hello JavaMail!</h1><p>这是一封测试邮件</p>"; message.setContent(htmlContent, "text/html; charset=utf-8"); // 4. 添加附件 MimeBodyPart attachment = new MimeBodyPart(); attachment.attachFile(new File("path/to/file.pdf")); // 替换实际路径 Multipart multipart = new MimeMultipart(); multipart.addBodyPart(attachment); message.setContent(multipart); // 5. 发送邮件 Transport.send(message); System.out.println("邮件发送成功！"); } catch (Exception e) { e.printStackTrace(); } } }

接收邮件（POP3/IMAP）

// 配置会话（参考发送邮件） Properties props = new Properties(); props.put("mail.pop3.host", "pop.qq.com"); props.put("mail.pop3.port", "995"); props.put("mail.pop3.ssl.enable", "true"); // 启用SSL Session session = Session.getDefaultInstance(props); try (Store store = session.getStore("pop3")) { // 1. 连接邮箱 store.connect("your_email@qq.com", "授权码"); // 2. 获取收件箱 Folder inbox = store.getFolder("INBOX"); inbox.open(Folder.READ_ONLY); // 3. 读取最新10封邮件 Message[] messages = inbox.getMessages(); for (int i = Math.max(0, messages.length - 10); i < messages.length; i++) { System.out.println("主题: " + messages[i].getSubject()); System.out.println("发件人: " + messages[i].getFrom()[0]); System.out.println("内容: " + messages[i].getContent()); } inbox.close(false); } catch (Exception e) { e.printStackTrace(); }

常见问题解决

1. 认证失败：

   

   • 检查是否使用授权码而非邮箱密码
   • 确认邮箱服务已开启（如 QQ 邮箱需单独启用 POP3/SMTP）

2. 连接超时：

   • 调整超时参数： props.put("mail.smtp.connectiontimeout", "5000"); // 5秒连接超时 props.put("mail.smtp.timeout", "10000"); // 10秒读写超时

3. 附件乱码：

   • 添加编码设置： attachment.setFileName(MimeUtility.encodeText("文件名.pdf"));

   安全实践

   1. 敏感信息保护：
      • 使用环境变量存储邮箱和授权码： String password = System.getenv("MAIL_PASSWORD");
   2. 加密传输：
      • 强制启用 TLS/SSL（mail.smtp.ssl.enable=true）

   ---

   应用场景

   • 用户注册验证码
   • 系统异常告警
   • 定时报表推送
   • 邮件批量通知

   提示：生产环境建议结合 Spring Boot 的 JavaMailSender 简化配置。

   ---

   引用说明：

   • 官方文档：Eclipse Angus Mail
   • RFC 5321 (SMTP 协议标准)
   • Oracle JavaMail 历史文档（兼容性参考）

   通过本指南,您可安全高效地集成邮件功能，建议测试时使用沙箱邮箱（如 Mailtrap），避免触发服务器风控。