本文详解如何在Java中通过javax.mail正确向多个收件人（BCC/CC/TO）批量发送邮件，重点解决因重复调用setRecipients()导致仅首/末地址生效的常见错误，并提供类型安全、线程安全的完整实现方案。
本文详解如何在java中通过javax.mail正确向多个收件人（bcc/cc/to）批量发送邮件，重点解决因重复调用`setrecipients()`导致仅首/末地址生效的常见错误，并提供类型安全、线程安全的完整实现方案。
在使用 javax.mail 发送邮件时，一个高频误区是：误将 setRecipients() 视为“追加”操作，实则它是完全覆盖式赋值。正如提问者所遇问题——在循环中反复调用 msg.setRecipients(...)，每次都会覆盖前一次设置的收件人列表，最终仅保留最后一次传入的单个地址（即循环末尾的邮箱），造成“只发给最后一个用户”的假象。
根本原因在于 Message.setRecipients(RecipientType, Address[]) 的语义是 一次性设置全部收件人，而非增量添加。因此，正确做法是：先聚合所有目标地址，再统一调用一次 setRecipients()。
✅ 正确实现步骤
统一构建 InternetAddress[] 数组（推荐强类型集合）
避免字符串拼接或逐个解析，直接将数据库查询出的邮箱字符串转换为 InternetAddress 对象，并存入 List<InternetAddress>；最后转为数组传入。使用 BCC 时注意隐私与兼容性
BCC（密送）适用于群发通知类场景，收件人彼此不可见。但需确保 SMTP 服务器支持多地址 BCC（主流服务如 Gmail、Outlook、企业邮件网关均支持）。
以下是经过生产验证的完整示例代码：
import javax.mail.*;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.sql.*;
import java.util.ArrayList;
import java.util.List;
// 假设已配置好 Session（含认证、SMTP主机等）
Session session = Session.getInstance(props, new Authenticator() {
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication("sender@example.com", "app-password");
}
});
Message msg = new MimeMessage(session);
msg.setFrom(new InternetAddress("sender@example.com"));
msg.setSubject("系统通知：批量消息已送达", "UTF-8");
msg.setText("这是一条面向多位用户的统一通知。", "UTF-8", "plain");
// ✅ 步骤1：从数据库安全获取邮箱列表（使用 try-with-resources 自动释放资源）
List<InternetAddress> bccAddresses = new ArrayList<>();
String sql = "SELECT email FROM user WHERE status = ? AND email IS NOT NULL";
try (Connection conn = connect();
PreparedStatement ps = conn.prepareStatement(sql)) {
ps.setString(1, "ACTIVE");
try (ResultSet rs = ps.executeQuery()) {
while (rs.next()) {
String email = rs.getString("email").trim();
if (!email.isEmpty() && email.contains("@")) {
bccAddresses.add(new InternetAddress(email, false)); // false → 不尝试解析显示名
}
}
}
} catch (SQLException | AddressException e) {
throw new RuntimeException("构建收件人列表失败", e);
}
// ✅ 步骤2：一次性设置全部BCC地址（关键！）
if (!bccAddresses.isEmpty()) {
InternetAddress[] addressesArray = bccAddresses.toArray(new InternetAddress[0]);
msg.setRecipients(Message.RecipientType.BCC, addressesArray);
} else {
throw new IllegalStateException("无有效收件人，终止发送");
}
// ✅ 步骤3：发送（建议添加超时与异常重试逻辑）
Transport.send(msg);
System.out.println("✅ 已成功发送至 " + bccAddresses.size() + " 位用户");⚠️ 关键注意事项
- 不要在循环内调用 setRecipients()：这是本问题的根源，务必杜绝。
- 校验邮箱格式：数据库中可能存在空值、非法格式（如无 @），应在构造 InternetAddress 前过滤，避免 AddressException。
- BCC 地址数量限制：部分 SMTP 服务商对单次请求的收件人总数有限制（如 Gmail 为 500/天，单封信建议 ≤ 100）。若用户量极大，应分批发送并加入合理延时。
- 编码与国际化：若邮箱含中文昵称（如 "张三 <zhang@example.com>"），需将 InternetAddress 构造函数第二个参数设为 true 并确保 JVM 使用 UTF-8 编码。
- 性能与资源：InternetAddress.parse(String) 内部会做轻量解析，但批量场景下仍推荐显式 new InternetAddress(email, false) 提升可读性与可控性。
✅ 总结
向多个收件人发送邮件的核心原则是：聚合地址 → 一次赋值 → 统一发送。摒弃循环赋值思维，采用 List<InternetAddress> + toArray() 模式，既符合 JavaMail 设计契约，又保障类型安全与执行效率。配合数据库连接管理、邮箱校验和错误处理，即可构建健壮、可维护的企业级邮件通知模块。
立即学习“Java免费学习笔记（深入）”；
