Azure Function定时器触发器异步调用冲突问题求助：通知发送偶发性失败

看起来你碰到了一个典型的异步操作并发冲突问题——错误"An asynchronous call is already in progress. It must be completed or canceled before you can call this method"通常是因为同一个非线程安全的异步客户端实例被多个并发请求复用，导致前一个异步调用还没完成就发起了新的调用。结合你的代码来看，文件上传总是成功但邮件通知偶尔失败，说明问题大概率出在_mails.SendEmail方法的实现上。

问题根源分析 #

你的定时器触发的Function可能会存在以下场景导致冲突：

• 定时器触发频率较高，多个Function实例同时执行，共享了同一个非线程安全的邮件客户端实例
• _mails服务被注册为单例（Singleton），内部的邮件客户端（比如旧版SmtpClient、某些第三方邮件SDK实例）不支持并发异步调用

具体解决方案 #

1. 确保邮件客户端实例的线程安全 #

如果使用的是.NET自带的SmtpClient，注意旧版本的SmtpClient是非线程安全的，复用同一个实例发起异步调用必然会触发冲突。解决办法是每次发送邮件时创建新的实例：

public async Task SendEmail(List<string> recipients, string subject, string message)
{
    // 每次调用都创建独立的SmtpClient实例，并使用using确保资源释放
    using var smtpClient = new SmtpClient("your-smtp-server")
    {
        Credentials = new NetworkCredential("username", "password"),
        EnableSsl = true
    };

    var mailMessage = new MailMessage
    {
        From = new MailAddress("sender@your-domain.com"),
        Subject = subject,
        Body = message,
        IsBodyHtml = true
    };

    foreach (var recipient in recipients)
    {
        mailMessage.To.Add(recipient);
    }

    await smtpClient.SendMailAsync(mailMessage);
}

如果使用第三方邮件服务（比如SendGrid、AWS SES），请确认SDK的客户端是否支持并发：

• 如果SDK客户端是线程安全的，可以保留单例；
• 如果不支持，同样每次调用创建新的客户端实例。

2. 调整依赖注入的生命周期 #

检查你的_mails服务在DI容器中的注册方式：

• 如果当前是services.AddSingleton<IMails, Mails>()，改成services.AddScoped<IMails, Mails>()或者services.AddTransient<IMails, Mails>()，确保每次Function执行都获取新的Mails实例，避免共享非线程安全的内部资源。

3. 优化异常捕获排查 #

当前的catch块只抛出了异常消息，丢失了堆栈跟踪信息，不利于定位问题。修改SendNotification的catch块：

catch (Exception e)
{
    // 不要只抛出消息，保留完整异常上下文
    throw;
}

这样下次出现错误时，你能看到具体是哪个异步方法抛出的冲突，进一步确认问题点。

4. 调整Function并发设置（可选） #

如果你的定时器触发频率很高，可以在host.json中调整Function的并发度，避免过多实例同时运行导致冲突：

{
  "version": "2.0",
  "extensions": {
    "timer": {
      "schedule": "your-schedule"
    },
    "functions": {
      "maxConcurrentCalls": 1
    }
  }
}

不过这只是临时缓解，核心还是要解决客户端的线程安全问题。

总结 #

这个问题的核心是非线程安全的异步客户端被共享复用，解决的关键是确保每次邮件发送都使用独立的客户端实例，或者调整服务的生命周期避免共享非线程安全资源。按照上面的步骤排查和修改后，应该就能解决通知偶尔失败的问题了。

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