Java Mail SMTP多邮箱发送IllegalAddress异常处理方案咨询

这个问题我之前也遇到过——当收件人列表里混了无效地址时，整个邮件发送直接失败，完全没办法给其他有效地址投递，确实头疼。下面给你几个实用的解决方案，结合你的代码来调整就行：

1. 提前过滤格式无效的邮箱地址 #

最稳妥的方式是在设置收件人之前，先对邮箱数组做格式验证，把明显无效的地址过滤掉，避免后续触发IllegalAddressException。Java Mail自带的InternetAddress类就能帮我们做这件事：

先写一个工具方法来过滤有效地址：

private String[] filterValidEmailAddresses(String[] emails) {
    if (emails == null || emails.length == 0) {
        return new String[0];
    }
    List<String> validEmails = new ArrayList<>();
    for (String email : emails) {
        try {
            // 开启严格验证模式，确保邮箱格式合法
            InternetAddress.parse(email, true);
            validEmails.add(email);
        } catch (AddressException e) {
            // 记录无效地址的日志，方便后续排查
            log.warn("检测到无效邮箱地址: {}, 将跳过该收件人", email, e);
        }
    }
    return validEmails.toArray(new String[0]);
}

然后修改你原代码中设置收件人的逻辑，先过滤再设置：

if (type.equals(ALERT_MAIL)) {
    html = templateEngine.process("take1_email_template_alerts", context);
    // 过滤有效收件人
    String[] validToAddresses = filterValidEmailAddresses(toEmailAddress);
    if (validToAddresses.length > 0) {
        helper.setTo(validToAddresses);
    } else {
        log.warn("没有有效的收件人地址，邮件将终止发送");
        // 这里可以根据业务需求选择抛出自定义异常或直接返回
    }
} else if (type.equals(GENERAL_MAIL)) {
    html = templateEngine.process("take1_email_template_general", context);
    String[] validToAddresses = filterValidEmailAddresses(mail.getTo());
    if (validToAddresses.length > 0) {
        helper.setTo(validToAddresses);
    } else {
        log.warn("没有有效的收件人地址，邮件将终止发送");
    }
}

2. 配置SMTP允许部分发送（应对格式合法但实际无效的地址） #

有些地址格式是对的，但实际已经被注销（比如离职员工的邮箱），这种提前验证查不出来。这时候可以开启Java Mail的sendpartial属性，让SMTP服务器在遇到无效地址时，仍然给有效地址发送邮件：

如果是配置文件方式，添加：

mail.smtp.sendpartial=true

如果是代码里设置Session：

Properties props = new Properties();
props.put("mail.smtp.sendpartial", "true");
Session session = Session.getInstance(props);
// 用这个session创建MimeMessage

注意：这个功能依赖SMTP服务器的支持，不是所有服务器都兼容，所以建议和第一步的过滤配合使用，双重保障。

3. 拆分收件人逐个发送（极端场景可选） #

如果你的业务对邮件送达率要求极高，且SMTP不支持部分发送，可以考虑把收件人拆分，逐个发送。这样单个地址失败不会影响其他，但会增加发送次数，需要权衡：

// 假设已经完成第一步的格式过滤
List<String> validEmails = Arrays.asList(validToAddresses);
for (String email : validEmails) {
    try {
        // 重新创建邮件实例（可以把邮件内容封装成工具方法复用）
        MimeMessage message = emailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(message, MimeMessageHelper.MULTIPART_MODE_MIXED_RELATED, StandardCharsets.UTF_8.name());
        // 重复设置邮件内容、主题、发件人等逻辑
        helper.setTo(email);
        helper.setText(html, true);
        helper.setSubject(mail.getSubject());
        helper.setFrom(new InternetAddress(fromEmailAddress, fromPersonalName));
        // 处理抄送人、密送人、附件等
        if (null != mail.getCc()) {
            helper.setCc(filterValidEmailAddresses(mail.getCc()));
        }
        // ...其他设置逻辑
        emailSender.send(message);
    } catch (MessagingException | UnsupportedEncodingException e) {
        log.error("给收件人 {} 发送邮件失败", email, e);
        // 可选：添加重试逻辑
    }
}

推荐方案 #

优先使用第一步+第二步的组合：先过滤格式无效的地址，再开启sendpartial属性，既能避免大部分异常，又能应对格式合法但实际无效的地址，是性价比最高的方案。

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