Apache Mailet 3.8.0：如何仅获取SMTP信封收件人？

针对你遇到的James邮件处理场景，要严格区分SMTP信封收件人与邮件头收件人，可按以下步骤处理：

1. 直接从SMTP信封获取收件人/发件人 #

James框架中，SMTP信封信息（RCPT TO、MAIL FROM）存储在Envelope对象中，而非直接通过mail.getRecipients()获取。你需要显式调用信封相关方法：

import org.apache.james.core.Envelope;
import org.apache.james.core.MailAddress;

// 获取SMTP信封实例
Envelope envelope = mail.getEnvelope();

if (envelope != null) {
    // 获取RCPT TO指定的信封收件人（仅SMTP流程中会有）
    Collection<MailAddress> envelopeRecipients = envelope.getRecipients();
    // 获取MAIL FROM指定的信封发件人
    MailAddress envelopeSender = envelope.getSender();
} else {
    // 无SMTP信封的场景（如单元测试直接传入邮件文件）
    // 根据业务逻辑处理，比如抛出异常、返回空集合或提示无信封信息
}

这个方法能确保你拿到的是SMTP协议层面的收件人，不会混入邮件头中的CC/BCC收件人。

2. 判断邮件是否包含SMTP信封 #

直接检查Envelope是否为null即可：

boolean hasSmtpEnvelope = mail.getEnvelope() != null;

真实SMTP接收的邮件会有完整的Envelope实例，而直接从文件导入的邮件（如单元测试场景）则没有。

3. 修复单元测试逻辑 #

你的单元测试未模拟SMTP信封，导致测试场景与真实生产环境不符。需要在测试中手动构造Envelope并绑定到Mail对象：

import org.apache.james.core.Mail;
import jakarta.mail.internet.MimeMessage;

// 从文件加载测试邮件内容
MimeMessage message = loadTestMailFromFile("test-mail.eml");

// 构造模拟SMTP信封
Envelope testEnvelope = Envelope.builder()
    .sender(MailAddress.of("sender@test.com"))
    .addRecipient(MailAddress.of("recipient@test.com"))
    // 可添加多个收件人
    .addRecipient(MailAddress.of("another-recipient@test.com"))
    .build();

// 构建包含信封的测试Mail对象
Mail testMail = Mail.builder()
    .name("test-smtp-mail")
    .envelope(testEnvelope)
    .setMessage(message)
    .build();

这样测试时就能模拟真实SMTP接收流程，避免依赖邮件头收件人导致的错误测试结果。

4. 替换原有逻辑，避免 fallback 到邮件头 #

旧版本James中，mail.getRecipients()方法可能存在兼容逻辑：当无信封时自动返回邮件头的To/Cc/BCC收件人。你需要彻底替换这个调用，改为从Envelope获取，同时明确处理无信封的场景，避免错误数据集产生。

内容的提问来源于stack exchange，提问作者Finn Andre Worm