JavaMail/Jakarta Mail企业级邮件处理实战：从协议原理到生产环境最佳实践

1. 项目概述：为什么JavaMail依然是企业级邮件处理的基石

在当今这个即时通讯满天飞的时代，电子邮件作为一项古老而稳定的协议，依然是企业内外正式沟通、系统通知、用户注册验证的绝对主力。你可能觉得发邮件很简单，不就是点个“发送”按钮吗？但在后端开发的世界里，尤其是用Java构建的庞大系统中，如何稳定、可靠、可管理地通过程序自动发送和读取邮件，是一门实实在在的“手艺活”。我见过太多项目，初期图省事，随便写几行代码调用某个云服务商的SDK就把邮件功能对付过去了，结果一到业务量激增，或者需要处理复杂的邮件解析、附件下载时，就各种抓瞎，排查问题像大海捞针。

这就是为什么JavaMail API（现在官方称为Jakarta Mail）历经多年，依然是Java生态中处理邮件协议的“标准答案”。它不是什么新潮的技术，但就像家里的老工具箱，螺丝刀、扳手一应俱全，虽然不花哨，但遇到任何型号的螺丝螺母你都知道该怎么对付。它直接基于SMTP、POP3、IMAP这些底层协议进行封装，给你提供了最根本、最灵活的控制能力。无论是发送一封简单的文本邮件，还是处理带内嵌图片、多附件的复杂HTML邮件，或是从收件箱里定时拉取、解析特定主题的邮件并触发业务流程，JavaMail都能给你一套清晰、标准的实现路径。这次，我就结合自己踩过的坑和积累的经验，带你从零开始，彻底搞懂如何用JavaMail玩转邮件的发送与读取，让你不仅能写出能跑的代码，更能写出在生产环境里“稳如老狗”的邮件处理模块。

2. 核心原理与协议扫盲：邮件背后的“交通规则”

在动手写代码之前，我们必须先搞清楚邮件系统是怎么运转的。你可以把整个邮件系统想象成一个古老的、但极其高效的邮政网络，而SMTP、POP3、IMAP就是这套网络里的“交通规则”。

SMTP（Simple Mail Transfer Protocol），简单邮件传输协议，专门负责“寄信”。当你的Java程序要发送邮件时，它其实扮演了一个“邮件客户端”的角色，需要找到一家“邮局”（SMTP服务器），把写好的信（邮件内容）和收件人地址交给它。这个“邮局”会负责把信一路传递到收件人所在的“邮局”。这里的关键是身份验证：为了防止有人滥用“邮局”乱发垃圾邮件，现在的SMTP服务器几乎都要求发件人提供账号密码（或授权码）来证明“我是我”。常用的SMTP服务器端口是25（不加密）、465（SSL加密）和587（TLS加密起步）。强烈建议使用465或587端口，因为25端口在很多云服务商那里是默认封锁的，且通信过程明文传输，极不安全。

POP3（Post Office Protocol version 3）和IMAP（Internet Message Access Protocol）则负责“收信”。它们是你从“邮局”的“个人信箱”里取信的两种不同方式。

• POP3更像是一次性全部拿走。客户端连接到服务器，把信箱里的邮件全部下载到本地（比如你的Outlook或Foxmail），然后通常可以选择从服务器上删除这些邮件。这种方式简单，但对多设备同步不友好，你在手机上下载了，电脑上就看不到了。
• IMAP则高级得多，它把你的本地客户端变成了服务器邮箱的一个“镜像”或“视图”。所有邮件始终保留在服务器上，你在本地进行的读信、移动、删除等操作，都会同步到服务器。这样，你在手机、电脑、网页上看到的邮箱状态是完全一致的。对于需要程序化读取、管理邮件的场景，IMAP是更现代、更推荐的选择。

JavaMail API的伟大之处在于，它用一套统一的接口（Session,Transport,Store,Folder,Message等）封装了与这些不同协议的交互细节。你只需要配置好协议类型、主机地址、端口和认证信息，剩下的“脏活累活”——比如MIME（Multipurpose Internet Mail Extensions）格式的编码解码、附件的拆分与组装、字符集的转换——JavaMail都帮你处理好了。理解这些协议，是你后续调试连接超时、认证失败、编码乱码等问题的基础。

3. 环境准备与核心依赖配置

开始编码前，第一件事是把“工具箱”准备好。自从Java EE移交给了Eclipse基金会，JavaMail也更名为Jakarta Mail。对于新项目，我们应该使用新的Jakarta Mail API。

3.1 Maven依赖配置

在你的pom.xml文件中，添加以下依赖。注意，我们同时引入了核心API和SMTP、IMAP的实现模块。

<dependency> <groupId>com.sun.mail</groupId> <artifactId>jakarta.mail</artifactId> <version>2.0.1</version> </dependency>

注意：这里有一个非常容易混淆的点。jakarta.mail这个artifact实际上包含了API和SMTP的实现。但对于IMAP/POP3，你可能需要确保类路径下有对应的协议提供者。上述依赖通常已经足够，因为标准实现包（com.sun.mail:jakarta.mail）里已经包含了imap和pop3的实现。如果你遇到Unknown protocol: imaps的错误，可以显式引入com.sun.mail:jakarta.mail，或者检查是否包含了完整的实现jar包。

3.2 获取邮箱的SMTP/IMAP授权信息

这是新手最容易卡住的第一步。你不能直接用你的邮箱登录密码！为了安全，几乎所有主流邮箱服务商（如QQ邮箱、163邮箱、Gmail、企业邮箱）都要求使用授权码或专用密码来替代真实密码进行第三方客户端登录。

• QQ邮箱/163邮箱：登录网页版邮箱，进入“设置”->“账户”页面，找到“POP3/IMAP/SMTP服务”选项，开启它，系统会引导你生成一个16位的授权码。务必把这个授权码妥善保存，它只会显示一次！
• Gmail：需要开启“两步验证”，然后才能生成“应用专用密码”。
• 企业邮箱：通常由管理员提供SMTP和IMAP服务器地址、端口及专用密码。

请准备好以下信息，我们后续配置会用到：

• SMTP服务器地址（如smtp.qq.com）
• SMTP端口（如465或587）
• 发件邮箱账号
• SMTP授权码（非登录密码）
• IMAP服务器地址（如imap.qq.com）
• IMAP端口（如993）
• 收件邮箱账号（通常同发件账号）
• IMAP授权码（通常与SMTP授权码相同，但建议确认）

4. 邮件发送功能深度实现与避坑指南

有了理论基础和准备工作，我们现在来实战邮件发送。发送邮件的核心流程可以概括为：创建会话 -> 构建邮件 -> 建立传输连接并发送。

4.1 构建邮件会话（Session）

Session对象是JavaMail的起点，它包含了连接邮件服务器所需的所有配置信息，比如主机地址、端口、认证信息等。我们通过一个Properties对象来设置这些参数。

import java.util.Properties; import jakarta.mail.*; public class MailSender { private Session session; public void initSession() { Properties props = new Properties(); // 设置邮件传输协议为SMTP props.put("mail.transport.protocol", "smtp"); // 设置SMTP服务器地址 props.put("mail.smtp.host", "smtp.qq.com"); // 设置SMTP服务器端口（SSL加密端口） props.put("mail.smtp.port", "465"); // 需要身份验证 props.put("mail.smtp.auth", "true"); // 启用SSL加密 props.put("mail.smtp.ssl.enable", "true"); // 另一种设置SSL的方式（更通用），设置SocketFactory类 // props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory"); // 设置SocketFactory端口 // props.put("mail.smtp.socketFactory.port", "465"); // 创建Authenticator对象，用于提供认证信息 Authenticator authenticator = new Authenticator() { @Override protected PasswordAuthentication getPasswordAuthentication() { // 邮箱账号和SMTP授权码（不是登录密码！） return new PasswordAuthentication("your_email@qq.com", "your_smtp_auth_code"); } }; // 获取Session实例 session = Session.getInstance(props, authenticator); // 开启调试模式，会在控制台打印与服务器交互的详细日志，便于排查问题 session.setDebug(true); } }

实操心得：session.setDebug(true)在开发和调试阶段是神器，它会输出所有底层协议交互的日志。当你遇到“连接超时”、“认证失败”等问题时，第一反应就应该是打开调试模式，查看服务器返回的具体错误信息。生产环境记得关掉。

4.2 创建并组装复杂邮件内容（MimeMessage）

MimeMessage类代表一封符合MIME标准的邮件。构建一封邮件，就像组装一个多层结构的包裹。

import jakarta.mail.internet.*; public MimeMessage createComplexMessage() throws MessagingException { // 1. 创建邮件对象 MimeMessage message = new MimeMessage(session); // 2. 设置发件人、收件人、抄送、密送 // 发件人（地址和昵称） message.setFrom(new InternetAddress("sender@qq.com", "系统管理员")); // 收件人（TO） message.setRecipient(Message.RecipientType.TO, new InternetAddress("to@example.com")); // 抄送（CC） message.setRecipient(Message.RecipientType.CC, new InternetAddress("cc@example.com")); // 密送（BCC） - 其他收件人看不到此地址 // message.setRecipient(Message.RecipientType.BCC, new InternetAddress("bcc@example.com")); // 3. 设置邮件主题（注意编码） message.setSubject("这是一封测试邮件 - 带附件和内嵌图片", "UTF-8"); // 4. 创建邮件的“内容包裹”——一个多部分（Multipart）容器 MimeMultipart multipart = new MimeMultipart("mixed"); // “mixed”表示包含附件 // --- 第一部分：正文（可以是文本或HTML）--- // 创建一个MimeBodyPart来存放正文 MimeBodyPart textPart = new MimeBodyPart(); // 构建HTML内容，其中cid:image1引用下面内嵌图片的Content-ID String htmlContent = "<h1>你好！</h1>" + "<p>这是一封来自Java程序的<strong>HTML格式</strong>测试邮件。</p>" + "<p>内嵌图片：<img src='cid:image1' /></p>" + "<p>请查收附件。</p>"; textPart.setContent(htmlContent, "text/html;charset=UTF-8"); multipart.addBodyPart(textPart); // 将正文部分加入容器 // --- 第二部分：内嵌图片 --- MimeBodyPart imagePart = new MimeBodyPart(); // 读取本地图片文件 DataSource imageDataSource = new FileDataSource("/path/to/your/logo.png"); imagePart.setDataHandler(new DataHandler(imageDataSource)); // 设置Content-ID，与HTML中的cid:image1对应 imagePart.setContentID("<image1>"); // 设置Disposition为INLINE，表示内嵌资源 imagePart.setDisposition(MimeBodyPart.INLINE); multipart.addBodyPart(imagePart); // --- 第三部分：附件 --- MimeBodyPart attachPart = new MimeBodyPart(); DataSource fileDataSource = new FileDataSource("/path/to/your/document.pdf"); attachPart.setDataHandler(new DataHandler(fileDataSource)); // 设置附件文件名（处理中文文件名乱码） String fileName = MimeUtility.encodeText("项目文档.pdf"); attachPart.setFileName(fileName); // 设置Disposition为ATTACHMENT，表示附件 attachPart.setDisposition(MimeBodyPart.ATTACHMENT); multipart.addBodyPart(attachPart); // 5. 将组装好的多部分内容设置到邮件中 message.setContent(multipart); // 6. 设置邮件发送时间（可选） message.setSentDate(new Date()); return message; }

避坑指南：文件名和主题乱码：这是中文环境下的高频问题。对于邮件主题和附件文件名，务必使用MimeUtility.encodeText()方法进行编码。setSubject(subject, “UTF-8”)和setFileName(MimeUtility.encodeText(filename))是标准做法。如果忽略了，对方收到的可能是“=？UTF-8？B？xxxxx？=”这样的乱码字符。

4.3 建立连接并发送邮件

邮件组装好后，就需要通过Transport连接到SMTP服务器并发送。

public void sendMessage(MimeMessage message) throws MessagingException { // 获取传输对象 Transport transport = session.getTransport(); try { // 连接到服务器。这里传入的密码是Authenticator里设置的，通常无需重复传入。 // 但某些服务器或配置下，connect方法需要显式传入用户名密码。 transport.connect(session.getProperty("mail.smtp.host"), Integer.parseInt(session.getProperty("mail.smtp.port")), session.getProperty("mail.smtp.user"), // 可能需要单独配置mail.smtp.user session.getProperty("mail.smtp.password")); // 同上 // 发送邮件 transport.sendMessage(message, message.getAllRecipients()); System.out.println("邮件发送成功！"); } catch (Exception e) { // 这里应该记录更详细的日志，而不仅仅是打印堆栈 e.printStackTrace(); throw new MessagingException("邮件发送失败", e); } finally { // 务必关闭连接，释放资源 transport.close(); } }

注意事项：Transport的连接是昂贵的资源，必须在finally块中确保关闭，否则会导致连接泄漏。在生产环境中，强烈建议使用连接池（如来自commons-dbcp或HikariCP的思路，但需要自己封装Transport池）来管理邮件发送连接，尤其是在高并发发送场景下，能极大提升性能和稳定性。

5. 邮件读取功能深度实现与解析实战

读取邮件比发送更复杂一些，因为你需要处理服务器上邮件夹的结构，并解析可能千变万化的邮件内容。

5.1 连接到邮件存储（Store）并打开文件夹

读取邮件的第一步是连接到IMAP（或POP3）服务器，并打开对应的文件夹（如收件箱INBOX）。

import jakarta.mail.*; public class MailReader { private Store store; private Folder folder; public void connectAndOpenFolder() throws MessagingException { Properties props = new Properties(); // 使用IMAP协议 props.put("mail.store.protocol", "imap"); // IMAP服务器地址 props.put("mail.imap.host", "imap.qq.com"); // 使用SSL的端口 props.put("mail.imap.port", "993"); props.put("mail.imap.ssl.enable", "true"); // 某些服务器需要此设置 props.put("mail.imap.auth", "true"); Session session = Session.getInstance(props); session.setDebug(true); // 调试模式同样重要 // 1. 获取Store对象并连接 store = session.getStore("imap"); // 连接服务器，参数：主机、用户名、授权码 store.connect("imap.qq.com", "your_email@qq.com", "your_imap_auth_code"); // 2. 打开文件夹（这里打开收件箱） folder = store.getFolder("INBOX"); // 以读写模式打开（READ_ONLY 或 READ_WRITE）。READ_WRITE才能标记已读、删除邮件。 folder.open(Folder.READ_WRITE); System.out.println("收件箱总邮件数: " + folder.getMessageCount()); System.out.println("新邮件数: " + folder.getUnreadMessageCount()); } }

5.2 检索、遍历与解析邮件内容

打开文件夹后，我们可以获取邮件列表。为了提高效率，通常不会一次性获取所有邮件内容，而是先获取邮件头信息（UID、主题、发件人、日期等），根据需要再获取具体某封邮件的完整内容。

public void fetchAndParseMessages() throws MessagingException, IOException { // 1. 获取所有邮件（这里获取的是轻量级的Message对象，内容可能还未加载） Message[] messages = folder.getMessages(); // 2. 遍历邮件（建议从后往前，因为最新邮件在最后） for (int i = messages.length - 1; i >= 0; i--) { Message message = messages[i]; System.out.println("\n===== 邮件 " + (i+1) + " ====="); // 打印基本信息 System.out.println("主题: " + MimeUtility.decodeText(message.getSubject())); System.out.println("发件人: " + InternetAddress.toString(message.getFrom())); System.out.println("收件日期: " + message.getReceivedDate()); System.out.println("已读状态: " + (message.isSet(Flags.Flag.SEEN) ? "已读" : "未读")); // 3. 解析邮件正文和附件（这是一个核心且复杂的方法） parseMessageContent(message); } } private void parseMessageContent(Part part) throws MessagingException, IOException { // 获取内容类型 String contentType = part.getContentType(); String disposition = part.getDisposition(); // 情况1：附件 (ATTACHMENT) if (disposition != null && (disposition.equalsIgnoreCase(Part.ATTACHMENT) || disposition.equalsIgnoreCase(Part.INLINE))) { // 处理附件 String fileName = part.getFileName(); if (fileName != null) { fileName = MimeUtility.decodeText(fileName); // 解码文件名 System.out.println("发现附件: " + fileName); // 保存附件到本地 saveAttachment(part, "/path/to/save/" + fileName); } } // 情况2：多部分内容（如正文+附件） else if (contentType.toLowerCase().startsWith("multipart/")) { Multipart multipart = (Multipart) part.getContent(); int count = multipart.getCount(); for (int i = 0; i < count; i++) { // 递归解析每一部分 parseMessageContent(multipart.getBodyPart(i)); } } // 情况3：纯文本或HTML正文 else if (contentType.toLowerCase().startsWith("text/")) { Object content = part.getContent(); if (content != null) { System.out.println("正文类型: " + contentType); System.out.println("正文内容预览: " + content.toString().substring(0, Math.min(200, content.toString().length())) + "..."); // 如果是HTML，你可能想用Jsoup等库进一步解析 } } // 情况4：其他类型（如内嵌图片，Content-ID引用） else { // 检查是否是内嵌资源（通过Content-ID） String[] header = part.getHeader("Content-ID"); if (header != null && header.length > 0) { System.out.println("发现内嵌资源，Content-ID: " + header[0]); // 可以根据Content-ID将资源保存或关联到HTML正文中 } } } private void saveAttachment(Part part, String filePath) throws IOException, MessagingException { try (InputStream is = part.getInputStream(); FileOutputStream fos = new FileOutputStream(filePath)) { byte[] buffer = new byte[4096]; int bytesRead; while ((bytesRead = is.read(buffer)) != -1) { fos.write(buffer, 0, bytesRead); } System.out.println("附件已保存至: " + filePath); } }

核心技巧：使用UID管理邮件：folder.getMessages()返回的索引位置在邮件被删除或移动后可能会变化，不适合做唯一标识。IMAP协议提供了UID（唯一标识符），它是服务器为每封邮件分配的长期有效的唯一ID。在打开文件夹时，使用folder.open(Folder.READ_WRITE);后，可以通过folder.getUID(message)获取邮件的UID。将UID存储下来，下次可以直接通过folder.getMessageByUID(uid)精准定位到同一封邮件，这对于实现邮件的增量同步、状态跟踪等功能至关重要。

5.3 管理邮件状态：标记已读、删除与移动

程序化处理邮件时，经常需要改变邮件的状态。

public void manageMessage(Message message) throws MessagingException { // 1. 标记为已读 message.setFlag(Flags.Flag.SEEN, true); // 注意：对于IMAP，setFlag后需要调用folder的相应方法同步到服务器，但直接操作Message的flag通常会自动同步。 // 2. 标记为删除（在关闭文件夹时执行删除） message.setFlag(Flags.Flag.DELETED, true); // 3. 移动邮件到其他文件夹（例如“Processed”） Folder processedFolder = store.getFolder("Processed"); // 确保目标文件夹存在 if (!processedFolder.exists()) { processedFolder.create(Folder.HOLDS_MESSAGES); } Folder[] folders = {processedFolder}; // 复制邮件到新文件夹 folder.copyMessages(new Message[]{message}, processedFolder); // 在原文件夹标记删除 message.setFlag(Flags.Flag.DELETED, true); } // 在完成所有操作后，关闭文件夹并执行删除操作 public void close() throws MessagingException { if (folder != null && folder.isOpen()) { // expunge参数为true表示永久删除标记为DELETED的邮件 folder.close(true); } if (store != null && store.isConnected()) { store.close(); } }

重要警告：对邮件状态的操作（尤其是删除）要格外小心。建议在开发测试阶段，先使用Folder.READ_ONLY模式打开文件夹，避免误操作。folder.close(true)中的expunge操作是不可逆的，它会立即从服务器上删除所有标记为DELETED的邮件。有些服务器配置下，即使不expunge，标记为删除的邮件在会话结束后也会被清理。

6. 生产环境进阶：性能、稳定性与最佳实践

把功能跑通只是第一步，要让邮件模块在生产环境中可靠运行，还需要考虑更多。

6.1 连接池与资源管理

频繁地创建和销毁Transport和Store连接是性能杀手。对于发送邮件，可以自制一个简单的连接池：

public class SmtpTransportPool { private BlockingQueue<Transport> pool; private Session session; private int maxSize; public SmtpTransportPool(Session session, int maxSize) { this.session = session; this.maxSize = maxSize; this.pool = new LinkedBlockingQueue<>(maxSize); } public Transport borrowTransport() throws MessagingException, InterruptedException { Transport transport = pool.poll(); if (transport != null && transport.isConnected()) { return transport; } if (transport != null) { try { transport.close(); } catch (MessagingException ignored) {} } // 池为空或连接无效，创建新的（需控制总数） synchronized (this) { if (pool.size() + 1 > maxSize) { // 等待其他线程归还连接 return pool.take(); } transport = session.getTransport(); transport.connect(); // 使用Session中配置的认证信息连接 return transport; } } public void returnTransport(Transport transport) { if (transport != null && transport.isConnected()) { if (!pool.offer(transport)) { // 池已满，关闭连接 try { transport.close(); } catch (MessagingException ignored) {} } } } public void shutdown() { Transport transport; while ((transport = pool.poll()) != null) { try { transport.close(); } catch (MessagingException ignored) {} } } }

对于读取邮件的Store，由于其通常代表一个长期的用户会话，且涉及状态（如文件夹选择、邮件标记），池化意义不大，但应确保在长时间空闲后能自动重连。

6.2 异步发送与失败重试

邮件发送不应该阻塞主业务流程。使用线程池或消息队列（如RabbitMQ、Kafka）进行异步发送是标准做法。同时，必须实现失败重试机制。

@Component public class AsyncMailSender { @Autowired private ThreadPoolTaskExecutor taskExecutor; // Spring的线程池 public void sendAsync(MimeMessage message) { taskExecutor.execute(() -> { int maxRetries = 3; int retryCount = 0; boolean sent = false; while (!sent && retryCount < maxRetries) { try { // 调用同步发送方法 syncSend(message); sent = true; log.info("邮件发送成功。"); } catch (MessagingException e) { retryCount++; log.error("邮件发送失败，第{}次重试。错误：{}", retryCount, e.getMessage()); if (retryCount >= maxRetries) { log.error("邮件发送最终失败，已重试{}次。", maxRetries); // 将失败任务持久化到数据库或死信队列，供人工处理 persistFailedMessage(message); } else { try { // 指数退避等待 Thread.sleep(1000L * (long) Math.pow(2, retryCount)); } catch (InterruptedException ie) { Thread.currentThread().interrupt(); break; } } } } }); } // ... syncSend方法 }

6.3 安全性考量

• 不要硬编码密码/授权码：务必使用配置中心、环境变量或加密的配置文件来存储敏感信息。
• 验证发件人地址：防止邮件头伪造（SPF, DKIM, DMARC这些是服务器层面配置，但程序应使用可信的发件人地址）。
• 附件安全检查：对用户上传的附件进行病毒扫描、文件类型白名单校验，防止传播恶意文件。
• TLS加密：始终使用SSL/TLS加密连接（端口465或587），避免信息在传输中被窃听。

6.4 监控与日志

完善的日志是排查邮件问题的生命线。除了开启JavaMail的调试日志，还应在业务层面记录：

• 邮件发送/接收的请求ID、时间、发件人、收件人、主题。
• 邮件发送状态（成功、失败、重试次数）。
• 失败的具体原因（如网络超时、认证失败、收件人地址无效）。
• 附件的大小、类型。

将这些日志接入ELK（Elasticsearch, Logstash, Kibana）或类似的监控系统，可以方便地统计发送成功率、发现异常模式。

7. 常见问题排查与实战技巧实录

即使按照最佳实践来，在实际开发中还是会遇到各种稀奇古怪的问题。下面是我总结的一些高频问题及解决方法。

7.1 连接与认证问题

7.2 内容与编码问题

• 乱码问题：如前所述，主题和附件文件名必须用MimeUtility.encodeText()处理。正文内容也要确保setContent(text, “text/html;charset=UTF-8”)指定了正确的字符集。
• 附件丢失或损坏：检查附件的DataHandler是否正确设置，以及InputStream是否被正确读取和关闭。确保附件的Content-Type和Content-Disposition头设置正确。
• HTML图片不显示：内嵌图片的Content-ID（如<image1>）必须与HTML中src=”cid:image1”的cid值完全匹配（包括尖括号）。并且该图片部分的Disposition应设置为INLINE。

7.3 性能与稳定性问题

• 读取邮件超时：IMAP操作可能很慢，尤其是邮件很多或附件很大时。设置超时参数至关重要：

  props.put(“mail.imap.connectiontimeout”, “30000”); // 连接超时30秒 props.put(“mail.imap.timeout”, “30000”); // 读写超时30秒 props.put(“mail.imap.writetimeout”, “30000”); // 写超时30秒

• 内存溢出（OOM）：一次性调用folder.getMessages()获取成千上万封邮件的完整内容，很容易导致OOM。务必分页或增量获取，或者只先获取邮件头（FetchProfile）。

  // 只预加载需要的头部信息，提高性能 FetchProfile fp = new FetchProfile(); fp.add(FetchProfile.Item.ENVELOPE); // 包含主题、发件人、日期等 fp.add(FetchProfile.Item.FLAGS); // 包含已读、删除等标记 folder.fetch(messages, fp);

• 连接泄漏：这是最隐蔽的问题。确保每一个Transport、Store、Folder对象都在finally块或try-with-resources中正确关闭。使用连接池可以规范化管理。

7.4 一个实用的邮件监听器示例

对于需要实时处理新邮件的场景（如客服工单系统），可以使用Folder的MessageCountListener。

folder.addMessageCountListener(new MessageCountAdapter() { @Override public void messagesAdded(MessageCountEvent event) { // 当有新邮件到达时触发 Message[] newMessages = event.getMessages(); for (Message msg : newMessages) { try { System.out.println("收到新邮件，主题: " + msg.getSubject()); // 触发你的业务处理逻辑 processNewEmail(msg); // 处理完后可以标记为已读 msg.setFlag(Flags.Flag.SEEN, true); } catch (Exception e) { log.error("处理新邮件失败", e); } } } }); // 需要保持连接，并定期调用folder.idle()来监听服务器通知（IMAP IDLE命令） // 这是一个简化示例，实际实现需要处理连接保持和重连逻辑 new Thread(() -> { while (!Thread.interrupted() && folder.isOpen()) { try { folder.idle(); } catch (MessagingException e) { log.error("IDLE监听异常", e); // 尝试重连 break; } } }).start();

最后，记住邮件处理是一个与外部服务深度交互的模块，网络不可靠性是常态。你的代码必须对超时、中断、协议异常等情况有充分的容错处理。将邮件发送和读取视为一个独立的、可能失败的服务，通过异步、重试、降级、监控等手段，才能保证它在你复杂的业务系统中稳定运行。从简单的Transport.send()到构建一个健壮的企业级邮件处理组件，这中间的每一步思考和实践，才是真正价值的所在。