System.Net.Mail.SmtpClient通过SSL/TLS协议发送邮件失败问题解决

清疚 2023-01-01 01:45 114阅读 0赞

原文地址：[https://ken.io/note/smtpclient-sending-mail-failure-via-ssl-or-tls-solved][https_ken.io_note_smtpclient-sending-mail-failure-via-ssl-or-tls-solved]

## 一、问题描述 ##

### 1、问题现象 ###

通过`System.Net.Mail.SmtpClient`使用SSL/TLS协议发送邮件失败并报错  
**System.Net.Mail.SmtpException: Failure sending mail**

详细报错信息：

System.Net.Mail.SmtpException: Failure sending mail.
     ---> System.IO.IOException: Unable to read data from the transport connection: The connection was closed.
       at System.Net.Mail.SmtpReplyReaderFactory.ProcessRead(Byte[] buffer, Int32 offset, Int32 read, Boolean readLine)
       at System.Net.Mail.SmtpReplyReaderFactory.ReadLines(SmtpReplyReader caller, Boolean oneLine)
       at System.Net.Mail.SmtpReplyReaderFactory.ReadLine(SmtpReplyReader caller)
       at System.Net.Mail.SmtpConnection.GetConnection(String host, Int32 port)
       at System.Net.Mail.SmtpTransport.GetConnection(String host, Int32 port)
       at System.Net.Mail.SmtpClient.GetConnection()
       at System.Net.Mail.SmtpClient.Send(MailMessage message)
       --- End of inner exception stack trace ---
       at System.Net.Mail.SmtpClient.Send(MailMessage message)

### 2、问题原因 ###

这个问题跟SSL/TLS的协议版本有关系，SSL演化到3.0之后还是不够安全，因此又出现了SSL的升级版TLS协议，由于建立连接时的区别又分别被称为显示SSL和隐式SSL。SSL/TLS协议通常是结对出现SSL/TLS，不过大家还是喜欢简称为SSL。

> 目前最新版本是TLS 1.3，其他可用版本是TLS 1.2和TLS 1.1，其中TLS1.1计划于2020年弃用

所以，目前主流的邮箱服务商加密协议使用的都是TLS。  
但是`System.Net.Mail.SmtpClient` 不支持较新的TLS协议，具体的TLS协议版本支持情况MSDN上并未找到相关说明

截止到2020年3月受影响的框架版本：

*  .NET Core 2.0-3.1
 *  .NET Framework 2.0-4.8

目前微软MSDN已经将`System.Net.Mail.SmtpClient`标记为已过期(obsolete)，但源码中并未标记，也并未给出替代实现。

## 二、解决办法 ##

### 1、使用System.Web.Mail ###

`System.Web.Mail.SmtpMail`虽然已被标记为已过期，但是毕竟他支持新的SSL/TLS协议。

不过，需要注意的是，`System.Web.Mail.SmtpMail`，只适用于 .NET Framework(>=2.0)

**示例代码**：

using System.Web.Mail;
    using System;
    
    namespace Ken.IO.Util {
    
        class Program
        {
            public static void Main (string[] args)
            {
                MailMessage mmsg = new MailMessage();
                mmsg.Subject = "邮件测试主题ken.io";
                mmsg.BodyFormat = MailFormat.Html;
                mmsg.Body = "邮件测试正文ken.io";
                mmsg.BodyEncoding = Encoding.UTF8;
                //优先级
                mmsg.Priority = MailPriority.High;
                //发件者邮箱地址
                mmsg.From = "xxx@qq.com";
                //收件人收箱地址
                mmsg.To = "xxx@163.com";
                mmsg.Fields.Add("http://schemas.microsoft.com/cdo/configuration/smtpauthenticate", "1");
                //用户名
                mmsg.Fields.Add("http://schemas.microsoft.com/cdo/configuration/sendusername", mmsg.From);
                //密码
                mmsg.Fields.Add("http://schemas.microsoft.com/cdo/configuration/sendpassword", "password");
                //端口
                mmsg.Fields.Add("http://schemas.microsoft.com/cdo/configuration/smtpserverport", 465);
                //使用SSL
                mmsg.Fields.Add("http://schemas.microsoft.com/cdo/configuration/smtpusessl", "true");
                //Smtp服务器
                SmtpMail.SmtpServer = "smtp.qq.com";
                SmtpMail.Send(mmsg);
            }
        }
    }

### 2、使用MailKit ###

[MailKit][]是一个开源的基于MimeKit的跨平台邮件收发类库,支持IMAP、POP3、SMTP。其中SmtpClient也支持TLS协议.

可以很好的支持 .NET Core以及 .NET Framework框架的邮件发送

**安装Nuget Package**

#.NET Core
    dotnet add package MailKit --version 2.5.1
    
    #.NET Framework
    Install-Package MailKit -Version 2.5.1

**示例代码**：

using System;
    using MailKit.Net.Smtp;
    using MailKit;
    using MimeKit;
    
    namespace Ken.IO.Util {
    
        class Program
        {
            public static void Main (string[] args)
            {
                var message = new MimeMessage ();
                message.From.Add (new MailboxAddress ("test", "xxx@qq.com"));
                message.To.Add (new MailboxAddress ("test", "xxx@163.com"));
                message.Subject = "邮件测试";
                //html or plain
                var bodyBuilder = new BodyBuilder ();
                bodyBuilder.HtmlBody = "<b>邮件测试html正文ken.io</b>";
                bodyBuilder.TextBody = "邮件测试文本正文ken.io";
                message.Body = bodyBuilder.ToMessageBody();
    
                using (var client = new SmtpClient ()) {
                    client.ServerCertificateValidationCallback = (s,c,h,e) => true;
                    //smtp服务器，端口，是否开启ssl
                    client.Connect ("smtp.qq.com", 465, true);
                    client.Authenticate ("xxx@qq.com", "password");
                    client.Send (message);
                    client.Disconnect (true);
                }
            }
        }
    }

## 三、备注 ##

### 1、附录 ###

*  [https://www.ruanyifeng.com/blog/2014/02/ssl\_tls.html][https_www.ruanyifeng.com_blog_2014_02_ssl_tls.html]
 *  [https://docs.microsoft.com/zh-cn/dotnet/api/system.net.mail.smtpclient][https_docs.microsoft.com_zh-cn_dotnet_api_system.net.mail.smtpclient]
 *  [https://docs.microsoft.com/zh-cn/dotnet/api/system.web.mail.smtpmail][https_docs.microsoft.com_zh-cn_dotnet_api_system.web.mail.smtpmail]
 *  [https://zh.wikipedia.org/wiki/傳輸層安全性協定][https_zh.wikipedia.org_wiki]

[https_ken.io_note_smtpclient-sending-mail-failure-via-ssl-or-tls-solved]: https://ken.io/note/smtpclient-sending-mail-failure-via-ssl-or-tls-solved
[MailKit]: https://github.com/jstedfast/MailKit
[https_www.ruanyifeng.com_blog_2014_02_ssl_tls.html]: https://www.ruanyifeng.com/blog/2014/02/ssl_tls.html
[https_docs.microsoft.com_zh-cn_dotnet_api_system.net.mail.smtpclient]: https://docs.microsoft.com/zh-cn/dotnet/api/system.net.mail.smtpclient
[https_docs.microsoft.com_zh-cn_dotnet_api_system.web.mail.smtpmail]: https://docs.microsoft.com/zh-cn/dotnet/api/system.web.mail.smtpmail
[https_zh.wikipedia.org_wiki]: https://zh.wikipedia.org/wiki/%E5%82%B3%E8%BC%B8%E5%B1%A4%E5%AE%89%E5%85%A8%E6%80%A7%E5%8D%94%E5%AE%9A