Azure Web App部署后无法通过Azure Communication Email发送邮件

针对你用.NET后端+React前端开发的应用，本地测试正常但部署到Azure Web App后无法发送邮件的问题，结合你提供的Azure Communication Services邮件代码，按以下步骤逐一排查：

1. 确认Web App的应用配置是否完整正确 #

本地开发时配置存在appsettings.json，但部署到Azure后，Web App会优先读取应用程序设置里的配置项，而非本地配置文件：

• 登录Azure Portal，找到你的Web App，进入「配置」→「应用程序设置」
• 检查是否存在以下配置项，且值与本地测试时一致（注意配置层级用双下划线分隔）：
  • EmailService__CommunicationServicesEndpoint
  • EmailService__TenantId
  • EmailService__ClientId
  • EmailService__ClientSecret
  • EmailService__AccountingDepartment下的相关配置
• 重点检查ClientSecret是否复制完整，有没有多余空格或遗漏字符

2. 验证服务主体的权限配置 #

你的代码用ClientSecretCredential认证，需确保Azure AD中对应的服务主体（即ClientId指向的应用）拥有正确权限：

• 进入Azure AD →「企业应用程序」，找到该服务主体
• 进入「权限」→「添加权限」，搜索并选择「Azure Communication Services」
• 添加应用权限（而非委派权限）中的Email.Send权限
• 点击「授予管理员同意」，确保权限生效（这一步很容易遗漏）

3. 检查Azure Communication Services邮件资源配置 #

• 确认你使用的发件人地址（senderAddress）已在Azure Communication Services的Email资源中完成验证：
  • 进入Azure Communication Services资源 →「Email」→「发件人地址」，检查该地址是否显示为「已验证」
  • 如果是自定义域名发件人，需确保域名的DNS验证记录已正确配置并生效
• 检查Email资源的配额限制：进入「Email」→「配额」，确认当日发送量未超过限制

4. 排查Web App的网络访问限制 #

如果Web App配置了出站网络限制，可能无法访问Azure Communication Services的端点：

• 进入Web App →「网络」→「出站流量」，检查是否启用了VNet集成或防火墙规则
• 临时将出站规则设置为「允许所有出站流量」，测试邮件是否能发送
• 如果测试成功，再针对性添加Azure Communication Services的IP范围到允许列表

5. 查看详细错误日志定位问题 #

代码中捕获了RequestFailedException但重新包装成了通用Exception，需查看原始错误信息：

• 启用Web App的应用服务日志：进入「监视」→「日志」，开启「应用服务日志」并设置级别为「详细」
• 触发邮件发送操作后，在「日志流」中查看具体的错误代码和消息：
  • 401错误：大概率是ClientId/ClientSecret错误，或服务主体权限未生效
  • 403错误：发件人地址未验证、配额超出，或服务主体无权限
  • 404错误：CommunicationServicesEndpoint配置错误，端点不存在

6. 检查Azure DevOps部署管道的配置替换 #

如果用Azure DevOps部署，需确保部署过程中正确注入生产环境配置：

• 检查DevOps管道中的「Azure App Service部署」任务，是否启用了「应用设置」的变量替换
• 确认管道中的变量组或配置文件包含正确的生产环境邮件配置，且部署时已覆盖Web App的默认设置

附你提供的邮件服务代码（格式化后） #

public EmailService(IConfiguration configuration)
{
    var endpoint = configuration["EmailService:CommunicationServicesEndpoint"];
    var tenantId = configuration["EmailService:TenantId"];
    var clientId = configuration["EmailService:ClientId"];
    var clientSecret = configuration["EmailService:ClientSecret"];

    _emailSettings = configuration.GetSection("EmailService:AccountingDepartment").Get<EmailSettings>()!;

    var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

    _emailClient = new EmailClient(new Uri($"https://{endpoint}.communication.azure.com/"), credential);
}

public async Task SendEmailAsync(
    string subject,
    string htmlContent,
    List<string> toRecipients,
    List<string> ccRecipients,
    List<string> bccRecipients,
    string senderAddress,
    List<string> replyToAddresses)
{
    var emailContent = new EmailContent(subject)
    {
        Html = htmlContent
    };

    var toEmailAddresses = toRecipients.Where(email => !string.IsNullOrWhiteSpace(email)).Select(email => new EmailAddress(email)).ToList();
    var ccEmailAddresses = ccRecipients?.Where(email => !string.IsNullOrWhiteSpace(email)).Select(email => new EmailAddress(email)).ToList() ?? [];
    var bccEmailAddresses = bccRecipients?.Where(email => !string.IsNullOrWhiteSpace(email)).Select(email => new EmailAddress(email)).ToList() ?? [];

    var emailRecipients = new EmailRecipients(toEmailAddresses, ccEmailAddresses, bccEmailAddresses);

    var emailMessage = new EmailMessage(senderAddress, emailRecipients, emailContent);

    if (replyToAddresses != null)
    {
        foreach (var replyToAddress in replyToAddresses.Where(email => !string.IsNullOrWhiteSpace(email)))
        {
            emailMessage.ReplyTo.Add(new EmailAddress(replyToAddress));
        }
    }

    try
    {
        var emailSendOperation = await _emailClient.SendAsync(WaitUntil.Completed, emailMessage);

        string operationId = emailSendOperation.Id;
    }
    catch (RequestFailedException ex)
    {
        throw new Exception("Failed to send email.", ex);
    }
}

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