本文介绍一种轻量、可靠且生产就绪的方式，通过循环尝试多个 smtp 服务器并结合重试机制，实现邮件发送服务的高可用性，避免单点故障。
本文介绍一种轻量、可靠且生产就绪的方式，通过循环尝试多个 smtp 服务器并结合重试机制，实现邮件发送服务的高可用性，避免单点故障。
在企业级邮件服务中，依赖单一 SMTP 服务器存在明显风险：网络抖动、认证失败、服务宕机或临时限流都可能导致邮件发送中断。为提升系统健壮性，最佳实践是配置一组备用 SMTP 服务器（standby SMTP servers），并在主服务器连续失败时自动降级至下一节点——即实现「故障转移（failover）」而非简单重试。
以下是一个经过生产验证的 Java + Spring 实现方案，无需引入复杂中间件（如负载均衡器或消息队列），完全在应用层可控、可监控、可扩展：
✅ 核心设计原则
- 顺序降级：按预定义优先级依次尝试 server_1 → server_2 → server_3，不并行（避免资源竞争与状态混乱）；
- 每节点独立重试：对每个 SMTP 服务器最多重试 N 次（如 3 次），含连接超时、认证失败、发送异常等全链路错误；
- 快速失败 + 明确兜底：任一服务器连续失败后立即切换；全部失败则抛出明确异常，便于告警与人工介入；
- 运行时隔离：每次使用 JavaMailSenderImpl 新实例，避免跨服务器复用导致配置污染或线程安全问题。
? 示例代码（精简可部署版）
@Service
public class FailoverEmailService {
private static final int MAX_RETRIES_PER_SERVER = 3;
private static final long RETRY_DELAY_MS = 1000L;
private final List<SmtpConfig> smtpConfigs; // 封装 host/port/cred 等
private final MimeMessageCreator mimeMessageCreator;
public FailoverEmailService(
@Value("${email.smtp.servers}") List<SmtpConfig> smtpConfigs,
MimeMessageCreator mimeMessageCreator) {
this.smtpConfigs = smtpConfigs;
this.mimeMessageCreator = mimeMessageCreator;
}
public SendEmailResponse sendEmail(DtoEmailMessage dtoEmailMessage) {
for (SmtpConfig config : smtpConfigs) {
try {
MimeMessage mimeMessage = mimeMessageCreator.createMessage(dtoEmailMessage);
JavaMailSenderImpl sender = buildSender(config);
// 使用 Spring Retry（推荐）或轻量重试工具（如 resilience4j）
new RetryTemplate()
.execute(ctx -> {
sender.send(mimeMessage);
return null;
}, ctx -> {
log.warn("SMTP server {} failed (attempt {}/{}): {}",
config.getHost(), ctx.getRetryCount() + 1, MAX_RETRIES_PER_SERVER, ctx.getLastThrowable().getMessage());
return null;
});
String msgId = mimeMessage.getMessageID();
String recipient = dtoEmailMessage.getTo().get(0); // 简化示例
return SendEmailResponse.ok(recipient, msgId);
} catch (Exception e) {
log.warn("All retries exhausted for SMTP server: {}", config.getHost(), e);
continue; // 尝试下一个
}
}
throw new EmailSendFailureException(
"Failed to deliver email after exhausting all %d configured SMTP servers".formatted(smtpConfigs.size()));
}
private JavaMailSenderImpl buildSender(SmtpConfig config) {
JavaMailSenderImpl sender = new JavaMailSenderImpl();
sender.setHost(config.getHost());
sender.setPort(config.getPort());
sender.setUsername(config.getUsername());
sender.setPassword(config.getPassword());
sender.setJavaMailProperties(buildMailProperties(config));
return sender;
}
private Properties buildMailProperties(SmtpConfig config) {
Properties props = new Properties();
props.put("mail.transport.protocol", "smtp");
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.starttls.enable", "true");
props.put("mail.smtp.timeout", "10000");
props.put("mail.smtp.connectiontimeout", "10000");
props.put("mail.smtp.writetimeout", "10000");
return props;
}
}? 配置建议（application.yml）：
email: smtp: servers: - host: smtp-primary.example.com port: 587 username: ${SMTP_USER} password: ${SMTP_PASS} - host: smtp-backup.example.com port: 587 username: ${SMTP_USER} password: ${SMTP_PASS}
⚠️ 关键注意事项
- 凭证安全：切勿硬编码密码；应通过 Spring Cloud Config、Vault 或环境变量注入，并启用 Jasypt 加密；
- 连接池与性能：JavaMailSenderImpl 本身无内置连接池，高频场景建议封装为 @Scope("prototype") Bean 或复用已配置好的连接池（如 Apache Commons Pool）；
- 监控与可观测性：务必记录每次切换行为（如 log.info("Switched to backup SMTP: {}", host)），并上报指标（如 email_smtp_failover_count）至 Prometheus；
- DNS 缓存风险：若 SMTP 域名解析失败，JVM 默认缓存 60s，建议设置 sun.net.inetaddr.ttl=30 避免长期不可用；
- 替代方案权衡：若架构允许，更推荐前置部署 HAProxy / Nginx TCP 负载均衡器，统一管理健康检查与故障转移，应用层仅对接 VIP。
✅ 总结
该方案以最小侵入性实现了 SMTP 故障转移能力，兼具可读性、可维护性与生产稳定性。它不依赖外部组件，易于单元测试（可 mock SmtpConfig 列表），也支持未来无缝升级为动态配置（如监听 Nacos 配置变更实时刷新 smtpConfigs）。对于中低频邮件场景（日均
