定时邮件发送任务偶发SMTP超时问题排查与解决咨询

云原生阿岚

2026-8-17

超时问题排查与解决

一、超时原因分析

超时设置未生效：代码中smtpClient.Timeout = 1800000;写在smtpClient.Send(mailMessage);之后，发送操作已执行完毕才设置超时，等于没生效，实际用的是默认超时时间（约100秒），一旦SMTP服务器响应延迟就会触发超时。
SmtpClient实例滥用：循环内每次发送都新建SmtpClient，频繁创建销毁TCP连接，长期运行会导致本地端口耗尽，或者被SMTP服务器判定为恶意请求，限制连接数。
未正确释放资源：SmtpClient未用using包裹，即使是局部变量，也可能存在连接未及时关闭的情况，积累后导致网络资源占用过高。
SMTP服务器频率限制：长期运行后，定时触发时短时间发送邮件，可能触发服务器的发送频率、并发连接限制，服务器主动拒绝或延迟响应，引发超时。

二、解决方法

修正超时设置顺序：在发送前设置超时，初始化SmtpClient时就配置：

var smtpClient = new SmtpClient(smtp)
{
    Port = port,
    EnableSsl = ssl,
    UseDefaultCredentials = false,
    DeliveryMethod = SmtpDeliveryMethod.Network,
    Credentials = new NetworkCredential(username, password),
    Timeout = 1800000 // 移到此处，发送前生效
};

复用SmtpClient实例：将SmtpClient的创建移到循环外部，用同一个实例发送所有邮件，SMTP协议支持连接复用，减少连接开销：

// 把SmtpClient初始化移到循环外
var smtpClient = new SmtpClient(smtp)
{
    Port = port,
    EnableSsl = ssl,
    UseDefaultCredentials = false,
    DeliveryMethod = SmtpDeliveryMethod.Network,
    Credentials = new NetworkCredential(username, password),
    Timeout = 1800000
};
using (smtpClient) // 用using确保资源释放
{
    foreach (DataRow row in dt.Rows)
    {
        // ... 构建mailMessage的逻辑
        smtpClient.Send(mailMessage);
        Console.WriteLine("Email Sent Successfully");
        // 可选：添加短延迟，避免触发服务器限流
        Thread.Sleep(1000);
    }
}

添加发送延迟：每发送一封邮件后暂停1-2秒，降低发送频率，规避SMTP服务器的限流策略。
优化数据库查询：给Assignment表加一个REMINDER_SENT状态字段，只查询未发送提醒的任务（SELECT * FROM Assignment WHERE REMINDER_SENT = 'N'），减少循环处理数量，同时避免重复发送。
捕获具体异常：替换通用的Exception捕获，改为捕获SmtpException，可获取SMTP服务器返回的错误码，精准排查服务器端问题：

catch (SmtpException smtpEx)
{
    Console.WriteLine($"SMTP错误：{smtpEx.Message}，错误码：{smtpEx.StatusCode}");
}
catch (Exception ex)
{
    Console.WriteLine($"其他错误：{ex.Message}");
}

失败邮件重发列表实现逻辑

新增发送记录表：在Oracle数据库中创建EMAIL_SEND_LOG表，字段示例：
- LOG_ID（主键，自增）
- ASSIGNMENT_ID（关联任务ID）
- RECIPIENT（收件人邮箱）
- SUBJECT（邮件主题）
- BODY（邮件内容）
- SEND_STATUS（发送状态：0=待发送，1=成功，2=失败）
- RETRY_COUNT（已重试次数）
- MAX_RETRY（最大重试次数，比如3）
- NEXT_RETRY_TIME（下次重试时间）
- CREATE_TIME（创建时间）
- UPDATE_TIME（更新时间）
发送前记录日志：构建完mailMessage后，先插入一条待发送的日志记录：

// 伪代码：插入日志
string insertSql = "INSERT INTO EMAIL_SEND_LOG (ASSIGNMENT_ID, RECIPIENT, SUBJECT, BODY, SEND_STATUS, RETRY_COUNT, MAX_RETRY, NEXT_RETRY_TIME, CREATE_TIME) VALUES (:aid, :rec, :sub, :body, 0, 0, 3, SYSDATE + 1/24, SYSDATE)";
// 执行插入操作，获取LOG_ID

更新发送状态：
- 发送成功：将对应日志的SEND_STATUS改为1，更新UPDATE_TIME。
- 发送失败：将SEND_STATUS改为2，RETRY_COUNT加1，根据重试次数计算下次重试时间（比如指数退避：第1次重试10分钟后，第2次30分钟，第3次1小时），更新NEXT_RETRY_TIME和UPDATE_TIME；如果已达到最大重试次数，标记为最终失败，不再重试。
定时扫描重发：新增独立定时任务（比如每隔5分钟执行一次），查询SEND_STATUS=2且RETRY_COUNT < MAX_RETRY且NEXT_RETRY_TIME <= SYSDATE的记录，取出这些记录重新执行发送逻辑，发送完成后更新日志状态。
幂等性保障：发送时根据LOG_ID或ASSIGNMENT_ID+RECIPIENT做唯一校验，避免同一邮件被重复发送。

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

定时邮件发送任务偶发SMTP超时问题排查与解决咨询

一、超时原因分析 #

二、解决方法 #

一、超时原因分析

二、解决方法