Blazor Server发布至Azure后SMTP邮件发送失败崩溃如何解决

• 基于Blazor Server开发的业务应用，支持接收用户输入、完成计算后通过邮件向用户发送结果
• 本地localhost开发环境下全流程运行正常，发布到Azure平台后，执行邮件发送函数时应用直接崩溃，邮件无法送达
• 邮件发送逻辑编写在Index页面中，使用MailKit库实现邮件能力，本地配置可正常运行，部署后捕获到运行时异常，留存有异常信息截图、崩溃场景截图

Azure平台默认对托管应用的出站25端口实施访问拦截，这是该问题的核心诱因：

1. 本地开发环境网络无25端口出站限制，SMTP连接可正常建立，因此功能运行正常
2. 部署到Azure后，25端口的TCP连接会被平台策略直接阻断，MailKit建立SMTP连接时会抛出网络重置、连接超时类异常
3. 如果组件层没有对这类异常做捕获处理，异常会直接冒泡到应用宿主，触发进程退出，表现为应用直接崩溃

其他常见的配套诱因：

• 配置未做多环境区分，线上环境沿用了本地无加密25端口的SMTP连接配置
• 免费/共享层级的Azure App Service强制拦截25端口，无解除渠道
• 未配置全局异常处理，邮件模块的异常直接中断整个请求管道

1. 替换SMTP连接端口，强制使用加密传输 #

完全弃用25端口作为线上发信端口，改用SMTP标准提交端口：

• 启用STARTTLS加密时使用587端口
• 启用直接SSL/TLS加密时使用465端口

不要把配置写死在代码里，通过配置系统按环境加载对应参数，MailKit连接参考代码：

// 邮件发送逻辑不要直接写在组件的生命周期方法里，建议抽成单独的服务注册到DI容器
public class EmailService
{
    private readonly IConfiguration _config;
    private readonly ILogger<EmailService> _logger;

    public EmailService(IConfiguration config, ILogger<EmailService> logger)
    {
        _config = config;
        _logger = logger;
    }

    public async Task<bool> TrySendResultEmailAsync(string toAddress, string content, CancellationToken ct)
    {
        try
        {
            var message = new MimeMessage();
            message.From.Add(new MailboxAddress(_config["Smtp:FromName"], _config["Smtp:FromAddress"]));
            message.To.Add(MailboxAddress.Parse(toAddress));
            message.Subject = "您的计算结果";
            message.Body = new TextPart("plain") { Text = content };

            using var client = new MailKit.Net.Smtp.SmtpClient();
            // 线上环境端口配置为587或465，开启对应加密选项
            await client.ConnectAsync(
                host: _config["Smtp:Host"],
                port: int.Parse(_config["Smtp:Port"]),
                useSsl: bool.Parse(_config["Smtp:UseTls"]),
                cancellationToken: ct);
            await client.AuthenticateAsync(_config["Smtp:Username"], _config["Smtp:Password"], ct);
            await client.SendAsync(message, ct);
            await client.DisconnectAsync(true, ct);
            return true;
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "向{ToAddress}发送结果邮件失败", toAddress);
            return false;
        }
    }
}

2. 补全异常兜底逻辑 #

所有邮件发送逻辑必须包裹在异常捕获块中，禁止MailKit的异常直接冒泡到Blazor组件层：

• 单独捕获SmtpCommandException，处理账号密码错误、收件人地址无效、发信权限不足类错误
• 单独捕获SmtpProtocolException、IOException，处理端口拦截、连接超时、网络重置类错误
• 异常发生时记录详细日志，给前端返回友好的业务提示，不要直接抛出未处理异常

3. 按Azure服务层级调整配置 #

• 若使用免费F1、共享D1层App Service：不要尝试申请开放25端口，这两个层级的25端口拦截为强制策略，必须使用587/465端口发信
• 若使用基础B级及以上付费层App Service：使用587/465端口仍有连接问题时，可提交Azure支持工单申请解除出站IP的25端口限制，但生产环境仍优先推荐使用加密提交端口，稳定性更高

4. 生产环境优化建议 #

不要在应用内直接对接公共SMTP服务，优先使用Azure生态内的邮件能力：

• 采用Azure Communication Services Email服务，和Azure网络天然打通，无端口拦截问题，提供官方.NET SDK，可直接集成到Blazor应用
• 如需使用第三方邮件服务，可选择Azure市场集成的SendGrid、Mailgun等专业发信服务，默认适配Azure网络策略，送达率更有保障

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