C#如何实现邮件发送功能_C#使用SMTP发送带附件的邮件【工具类】-C#.Net教程-PHP中文网

SmtpClient默认发不出去，因Gmail等强制TLS/SSL且校验发件人、附件名编码、大小限制；需设EnableSsl=true、Credentials为完整邮箱+授权码、附件用ContentType.Name指定UTF8编码、发送前校验文件大小。

c#如何实现邮件发送功能_c#使用smtp发送带附件的邮件【工具类】

直接用 SmtpClient 发带附件的邮件是可行的，但默认配置下极大概率发不出去——不是认证失败，就是被当成垃圾邮件，或者附件乱码、超限、丢失。关键不在“会不会写”，而在“怎么配才真正可用”。

为什么 `SmtpClient` 默认发不出去

现代邮箱（Gmail、Outlook、QQ 邮箱等）基本禁用了明文 SMTP 认证，强制要求 TLS/SSL；同时对发信频率、发件人域名、HELO 声明、附件类型都有校验。直接 new 一个 SmtpClient 并填入账号密码，十有八九会抛出 AuthenticationFailedException 或 SmtpException（错误信息类似 “The server response was: 5.7.0 Authentication Required”）。

必须显式设置以下几点：

EnableSsl = true（注意：不是所有端口都支持，Port = 587 对应 EnableSsl = true，而 Port = 465 通常需设为 UseDefaultCredentials = false + 手动启用 SSL）
Credentials 必须是 NetworkCredential，且用户名通常是完整邮箱地址（如 "user@gmail.com"），不是昵称或 ID
DeliveryMethod = SmtpDeliveryMethod.Network（避免误用 PickupDirectory）
发件人地址（MailMessage.From）必须与认证账号一致，否则多数服务商拒绝投递

附件添加的三个易错点

附件看似只是调用 Attachments.Add()，但实际踩坑密集：

路径必须是绝对路径，相对路径在 IIS 或 Windows Service 下极易找不到文件，建议用 Path.GetFullPath() 校验

附件名含中文时，必须设置 ContentType.Name 并指定编码，否则 Outlook 显示乱码：

var attachment = new Attachment(filePath);
attachment.NameEncoding = Encoding.UTF8;
attachment.ContentType = new ContentType("application/octet-stream") { Name = "报告.pdf" };

单个附件超过 25MB（Gmail）、50MB（Outlook）会静默失败，SmtpClient.Send() 可能不抛异常但收件方收不到——务必在发送前用 new FileInfo(filePath).Length 检查大小并提示用户

推荐封装成可复用的工具类（.NET 6+）

不要每次发邮件都重复写一堆配置。下面这个轻量工具类覆盖了主流场景，且把敏感配置外移：

public class EmailSender
{
    private readonly string _host;
    private readonly int _port;
    private readonly string _userName;
    private readonly string _password;
<pre class="brush:php;toolbar:false;">public EmailSender(string host, int port, string userName, string password)
{
    _host = host;
    _port = port;
    _userName = userName;
    _password = password;
}

public bool Send(string to, string subject, string body, List<string> attachmentPaths = null)
{
    try
    {
        var msg = new MailMessage(_userName, to, subject, body)
        {
            IsBodyHtml = true,
            BodyEncoding = Encoding.UTF8,
            SubjectEncoding = Encoding.UTF8
        };

        if (attachmentPaths?.Count > 0)
        {
            foreach (var path in attachmentPaths)
            {
                if (!File.Exists(path)) continue;
                var att = new Attachment(path);
                att.NameEncoding = Encoding.UTF8;
                msg.Attachments.Add(att);
            }
        }

        using var client = new SmtpClient(_host, _port)
        {
            EnableSsl = _port == 587 || _port == 465,
            Credentials = new NetworkCredential(_userName, _password)
        };
        client.Send(msg);
        return true;
    }
    catch (Exception ex) when (ex is SmtpException or IOException)
    {
        // 记录 ex.ToString()，尤其关注 InnerException.Message
        return false;
    }
}</string>

}

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

使用示例：

var sender = new EmailSender("smtp.gmail.com", 587, "me@gmail.com", "app-specific-password");
sender.Send("to@example.com", "测试", "<p>正文</p>", new[] { @"C:\tmp\file.pdf" }.ToList());

注意：Gmail 必须用「应用专用密码」而非账户密码。

调试时最该看的三处日志

发不出邮件时，别急着改代码。先确认这三项：

SMTP 服务器返回的原始响应：捕获 SmtpException 的 StatusCode 和 InnerException.Message，例如 SmtpStatusCode.MustIssueStartTlsFirst 表示没开 TLS
Windows 事件查看器 → 应用程序日志里是否有 System.Net.Mail 相关警告（需开启 system.net 跟踪，见 Microsoft 文档）
用 Wireshark 抓包看 TCP 三次握手是否成功、TLS 握手是否完成——很多公司内网会拦截 587 端口

附件名乱码、发件人被拒、连接超时……这些问题背后往往不是 C# 写错了，而是 SMTP 服务端策略和本地网络环境共同作用的结果。配对、验证、日志，比堆代码更重要。