javax.mail.SendFailedException: 554 錯誤排查——163 郵箱發送頻率限制

現象

使用 JavaMail 發送郵件時拋出異常：

javax.mail.SendFailedException: Sending failed;
  nested exception is:
    class javax.mail.MessagingException: 554 MI:STC 0,smtp10,DsCowLC7LwPACzRN7qcQAA--.2883S2 1295256512

根因分析

• 錯誤代碼 554：SMTP 永久性失敗，郵件被拒收。
• 關鍵標識 MI:STC：網易 163 郵箱反垃圾系統標識，代表「發送頻率超限，暫時封禁」。
• 非代碼問題：郵件內容、收件人、認證信息均正常，純屬發送方 IP/賬號觸發頻控策略。

觸發條件

• 單位時間內發送量超過閾值（如每分鐘 > 20 封、每小時 > 500 封）。
• 新註冊賬號未建立信譽，直接大量發送。
• 內容被判定為推廣/營銷郵件，觸發內容過濾進而限制頻率。

解決方案

1. 降低發送頻率：引入節流機制，如 Guava RateLimiter 或線程池 + 延遲隊列，控制 QPS。
2. 分散發送源：多賬號輪換、多 IP 代理池（需遵守服務商條款）。
3. 賬號養號：新賬號前期每天少量發送正常郵件，逐步提升信譽分。
4. 內容優化：避免敏感詞、過多鏈接、大圖附件；加入退訂鏈接、實體地址等合規元素。
5. 監控告警：捕獲 SendFailedException 解析錯誤碼，觸發熔斷/告警，避免持續重試加重封禁。
6. 備選通道：集成阿里雲郵件推送、SendGrid、Amazon SES 等商業郵件服務，SLA 更有保障。

代碼片段：指數退避重試

public void sendWithRetry(MimeMessage msg, int maxRetries) {
    for (int i = 0; i < maxRetries; i++) {
        try {
            Transport.send(msg);
            return;
        } catch (SendFailedException e) {
            if (e.getMessage().contains("554")) {
                long delay = (long) Math.pow(2, i) * 1000L; // 1s, 2s, 4s...
                log.warn("發送受限，{}ms 後重試 ({}/{})", delay, i+1, maxRetries);
                Thread.sleep(delay);
            } else {
                throw e;
            }
        }
    }
    throw new IllegalStateException("超過最大重試次數");
}

總結

554 錯誤本質是郵件服務商的流控保護，而非代碼缺陷。通過「頻率控制 + 賬號養號 + 內容合規 + 多通道備援」組合策略，可有效降低觸發概率，保障業務郵件送達率。