Debian系统下Mono发送SMTP邮件遇TLS版本错误的解决问询

核心问题分析 #

你遇到的TLSV1_ALERT_PROTOCOL_VERSION错误，本质是旧版本Mono（你当前使用的是6.12.0.182）对ServicePointManager的TLS版本设置兼容性不足，导致代码指定的TLS 1.2没有被实际应用，握手时仍尝试使用低版本协议。

具体修改方案 #

1. 升级Mono版本 #

Mono 6.12.0.182存在TLS握手相关的bug，建议直接升级到Mono 6.12.0.200及以上版本，或切换到Mono 7.x系列稳定版，新版本修复了大量跨平台TLS支持问题。

2. 调整现有代码的TLS配置 #

在代码中添加Mono专属的TLS环境配置，同时扩展支持的TLS版本范围：

public static bool sendEmail(string recipient, string subject, string body)
{
    // 强制Mono使用Btls提供器，确保TLS 1.2/1.3支持
    Environment.SetEnvironmentVariable("MONO_TLS_PROVIDER", "btls");
    // 启用新的Socket处理逻辑，解决旧版Mono的协议兼容问题
    AppContext.SetSwitch("System.Net.UseSocketsHttpHandler", true);
    // 同时指定TLS 1.2和TLS 1.3，覆盖更多兼容场景
    ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls13;

    MailAddress from = new MailAddress("xxx@xxx.com", "xxx");
    MailAddress to = new MailAddress(recipient);

    string content = "test";
    MailMessage message = new MailMessage(from, to);
    message.Subject = subject;
    message.Body = content;
    message.IsBodyHtml = true;
    message.ReplyTo = from;

    SmtpClient client = new SmtpClient("smtp.ionos.fr", 587);
    client.UseDefaultCredentials = false;
    client.Credentials = new NetworkCredential("xxx@xxx.com", "xxx"); 
    client.EnableSsl = true;
    client.Send(message);
    return true;
}

3. 替换为MailKit库（推荐方案） #

System.Net.Mail.SmtpClient已被官方标记为过时，跨平台兼容性差。改用专门的邮件处理库MailKit，它对TLS协议的支持更稳定：

1. 安装依赖包：在项目中执行dotnet add package MailKit（或通过NuGet管理器安装）
2. 替换代码为：

using MailKit.Net.Smtp;
using MimeKit;

public static bool sendEmail(string recipient, string subject, string body)
{
    var message = new MimeMessage();
    message.From.Add(new MailboxAddress("xxx", "xxx@xxx.com"));
    message.To.Add(new MailboxAddress("", recipient));
    message.Subject = subject;
    message.Body = new TextPart("html") { Text = "test" };

    using (var client = new SmtpClient())
    {
        // 明确指定使用TLS 1.2
        client.SslProtocols = System.Security.Authentication.SslProtocols.Tls12;
        client.Connect("smtp.ionos.fr", 587, MailKit.Security.SecureSocketOptions.StartTls);
        client.Authenticate("xxx@xxx.com", "xxx");
        client.Send(message);
        client.Disconnect(true);
    }
    return true;
}

验证方法 #

修改后重新运行代码，若仍有问题，可在Debian终端执行以下命令，确认系统能正常建立TLS 1.2连接：

openssl s_client -starttls smtp -connect smtp.ionos.fr:587 -tls1_2

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