如何使用Apache Commons Email实现邮件会话/线程分组？

嘿，这个问题我刚好有经验！虽然Apache Commons Email确实没提供直接的会话/线程分组开箱功能，但我们可以利用邮件协议的标准头字段来实现——毕竟所有主流邮件客户端（Gmail、Outlook、苹果邮件等）都是靠这些字段来关联同线程邮件的。

核心原理 #

邮件客户端识别会话的关键是三个标准邮件头字段：

• Message-ID：每封邮件的唯一标识，必须全局唯一
• In-Reply-To：标记当前邮件是回复哪一封邮件（值为目标邮件的Message-ID）
• References：标记当前邮件关联的所有历史邮件Message-ID（用空格分隔，至少包含初始邮件的ID即可）

Apache Commons Email支持手动添加自定义邮件头，所以我们可以通过设置这几个字段来实现会话分组。

具体实现步骤 #

1. 发送初始邮件（线程第一封）

首先给初始邮件生成一个唯一的Message-ID，并设置到邮件头里。建议用UUID生成，确保全局唯一，格式要符合RFC标准（用<>包裹，后缀带上你的发件域名）。

import org.apache.commons.mail.Email;
import org.apache.commons.mail.SimpleEmail;
import java.util.UUID;

public class EmailSender {
    public static void sendInitialEmail() throws Exception {
        Email email = new SimpleEmail();
        // 基础配置：SMTP服务器、端口、发件人、收件人等
        email.setHostName("smtp.your-domain.com");
        email.setSmtpPort(587);
        email.setAuthentication("your-email@domain.com", "your-password");
        email.setFrom("your-email@domain.com");
        email.addTo("recipient@example.com");
        email.setSubject("关于订单#1234的通知");
        email.setMsg("这是订单#1234的初始通知邮件...");

        // 生成并设置唯一Message-ID
        String messageId = "<" + UUID.randomUUID().toString() + "@your-domain.com>";
        email.addHeader("Message-ID", messageId);

        // 发送邮件，同时保存这个messageId（可以存在数据库或缓存里，后续跟进邮件要用）
        email.send();
        saveMessageIdForOrder("1234", messageId);
    }

    // 示例：保存Message-ID的方法（根据你的业务实现）
    private static void saveMessageIdForOrder(String orderId, String messageId) {
        // 比如存入数据库或Redis
    }
}

2. 发送同线程的跟进/回复邮件

当需要发送同一会话的后续邮件时，取出之前保存的初始邮件Message-ID，设置In-Reply-To和References头字段，同时建议主题加上Re:前缀（辅助客户端识别）。

public static void sendFollowUpEmail(String orderId) throws Exception {
    Email followUpEmail = new SimpleEmail();
    // 同样配置SMTP、发件人、收件人等基础信息
    followUpEmail.setHostName("smtp.your-domain.com");
    followUpEmail.setSmtpPort(587);
    followUpEmail.setAuthentication("your-email@domain.com", "your-password");
    followUpEmail.setFrom("your-email@domain.com");
    followUpEmail.addTo("recipient@example.com");
    followUpEmail.setSubject("Re: 关于订单#1234的通知");
    followUpEmail.setMsg("这是订单#1234的跟进通知，状态已更新...");

    // 取出之前保存的初始Message-ID
    String originalMessageId = getMessageIdForOrder(orderId);

    // 设置会话关联的头字段
    followUpEmail.addHeader("In-Reply-To", originalMessageId);
    followUpEmail.addHeader("References", originalMessageId);

    followUpEmail.send();
}

// 示例：获取保存的Message-ID的方法
private static String getMessageIdForOrder(String orderId) {
    // 从数据库或Redis取出之前保存的messageId
    return "<xxx-xxxx-xxxx@your-domain.com>";
}

注意事项 #

• Message-ID的格式必须严格符合RFC标准：必须用<>包裹，内部内容要保证全局唯一（UUID是最省心的选择）。
• 即使后续邮件主题有小改动，只要In-Reply-To和References设置正确，邮件客户端依然会把它们归到同一个会话里。
• 不管你用SimpleEmail还是HtmlEmail（Apache Commons Email的子类），都支持addHeader()方法，所以纯文本和HTML邮件都适用。

内容的提问来源于stack exchange，提问作者T0ll