.NET Framework从4.5升4.7后SendGrid异步发信失效求助

核心问题 #

原代码里SendEmailAsync是异步方法，但你在同步的void SendMail方法中直接调用却没有等待它完成，导致返回的Task一直处于WaitingForActivation状态，邮件实际并未发送。.NET Framework 4.7对异步任务的调度和生命周期管理更严格，这让原本在4.5中可能“侥幸”运行的代码暴露了本质问题。

修复步骤 #

1. 重构SendMail方法为异步方法 #

将方法改为async Task，并正确await异步操作，同时优化逻辑和异常处理：

public static async Task SendMail(EmailBuilder email)
{
    try
    {
        string apiKey = ConfigurationManager.AppSettings["SMTPPassword"];
        var client = new SendGridClient(apiKey);
        var from = new EmailAddress(ConfigurationManager.AppSettings["FromAddress"], ConfigurationManager.AppSettings["FromName"]);
        var subject = email.EmailSubject;
        var to = new EmailAddress(email.EmailAddress, $"{email.FirstName} {email.LastName}");
        
        // 简化文本内容判断逻辑
        var plainTextContent = (email.Style == 1 || email.Style == 2) ? email.Body : "";
        var msg = MailHelper.CreateSingleEmail(from, to, subject, plainTextContent, plainTextContent);
        
        // 关键：await异步方法，确保任务执行完成
        var response = await client.SendEmailAsync(msg);
        
        // 可选：检查响应状态，处理发送失败的情况
        // if (!response.IsSuccessStatusCode) { /* 这里可以添加失败后的重试或日志逻辑 */ }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"邮件发送失败: {ex.Message}");
        // 建议重新抛出异常，让调用端感知错误，避免静默吞掉问题
        throw;
    }
}

2. 调整调用端代码 #

原同步调用方式Mailer.SendMail(email)需要根据场景调整：

场景A：调用端为异步方法（推荐）

在异步方法内使用await调用，符合异步编程最佳实践：

// 假设调用方法本身是async修饰的
public async Task ProcessUserNotification()
{
    var email = new EmailBuilder 
    { 
        EmailAddress = "user@example.com",
        FirstName = "John",
        LastName = "Doe",
        EmailSubject = "通知邮件",
        Body = "这是测试内容",
        Style = 1
    };
    await Mailer.SendMail(email);
}

场景B：调用端必须同步（仅应急使用）

如果无法修改调用端为异步，可以用GetAwaiter().GetResult()避免异步死锁（比直接用.Result更安全）：

// 同步调用场景
var email = new EmailBuilder { /* 初始化参数 */ };
Mailer.SendMail(email).GetAwaiter().GetResult();

注意：同步调用异步方法存在死锁风险，尤其是在UI线程或ASP.NET上下文环境中，优先选择异步调用方式。

额外优化点 #

• 原代码中未使用的myMessage变量可直接删除，简化代码结构。
• 异常处理不要只输出日志，重新抛出异常能让调用端及时感知错误，便于排查问题。

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