如何用Apache Mail发送邮件列表？JavaFX+Apache Mail Commons发送异常排查

我之前做邮件发送工具时也碰到过几乎一模一样的问题，直接写死收件人数组没问题，但从数据库拉取就报错——哪怕确认了方法返回不为null。结合经验来看，问题大概率出在数据库返回的收件人列表里存在隐性的无效数据，下面给你几个具体的排查和解决方向：

1. 先排查收件人元素的有效性（最常见原因） #

虽然model.getEmailsBy(campaignName)返回的数组不是null，但里面的元素可能有问题：

• 存在空字符串、null元素（比如数据库里某条记录的邮箱字段为空）
• 邮箱格式不合法（比如缺少@、域名部分无效，或者带了多余的空格/换行符）
• 有不可见字符（比如数据库存储时意外混入的制表符）

你可以先把获取到的收件人数组打印出来，重点看每个元素的细节：

String[] dbEmails = model.getEmailsBy(campaignName);
for (int i = 0; i < dbEmails.length; i++) {
    // 用单引号包裹，方便直观看到前后是否有空格/不可见字符
    System.out.printf("收件人[%d]: '%s'%n", i, dbEmails[i]);
    // 简单的格式校验，快速定位无效邮箱
    if (dbEmails[i] == null || !dbEmails[i].matches("^[\\w.-]+@[\\w.-]+\\.[a-zA-Z]{2,}$")) {
        System.err.printf("无效邮箱[%d]: %s%n", i, dbEmails[i]);
    }
}

Apache Commons Mail对邮箱格式的校验很严格，哪怕有一个无效邮箱，整个发送流程都会抛出异常。

2. 过滤掉无效的收件人元素 #

如果排查出确实有无效元素，建议在使用前先过滤一遍：

String[] rawEmails = model.getEmailsBy(campaignName);
List<String> validRecipients = new ArrayList<>();
for (String email : rawEmails) {
    // 过滤null、空字符串，同时去除前后空格
    if (email != null && !email.trim().isEmpty()) {
        validRecipients.add(email.trim());
    }
}
// 转成数组再用于发送
String[] recipients = validRecipients.toArray(new String[0]);

用这个过滤后的数组去调用邮件发送接口，应该能解决大部分问题。

3. 对比手动数组和数据库数组的差异 #

如果上面的方法还没解决，你可以把手动初始化的数组和数据库返回的数组做一个全方位对比：

• 打印两个数组的长度，确认数量一致
• 打印每个元素的hashCode()，看是否有差异（比如手动的邮箱是"test@example.com"，数据库返回的是"test@example.com "，hashCode会不一样）
• 甚至可以把数据库返回的数组元素逐个复制到手动数组里测试，看是否能正常发送——如果能，说明是某个特定元素的问题。

4. 极端情况：数据库字符串编码问题 #

极少数情况下，数据库存储的邮箱字符串可能有编码乱码（比如用了非UTF-8编码存储），导致看起来是正常邮箱，但实际是乱码字符。你可以尝试转码后再使用：

String fixedEmail = new String(email.getBytes("ISO-8859-1"), StandardCharsets.UTF_8);

不过这个情况比较少见，优先排查前面的点。

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