如何用ASP.NET发送邮件？两种方法解决常见发送失败问题

在ASP.NET中发送邮件主要有两种常用方法：使用 .NET Framework 内置的 System.Net.Mail 命名空间（已过时但可用）或使用更现代的第三方库 MailKit,以下是两种方法的详细说明和代码示例：

方法1：使用 System.Net.Mail（.NET 内置）

适用于 .NET Framework 或兼容环境，但官方已标记为过时（.NET Core 3.0+ 及 .NET 5+ 推荐用 MailKit）。

核心步骤：

1. 添加命名空间：using System.Net; using System.Net.Mail;
2. 配置 SMTP 客户端 (SmtpClient)
3. 创建邮件对象 (MailMessage)
4. 发送邮件

示例代码：

public void SendEmail(string to, string subject, string body) { try { // 发件人邮箱和密码（或应用专用密码） string from = "sender@example.com"; string password = "your_password"; // 推荐使用配置存储 // 配置 SMTP 客户端 SmtpClient smtpClient = new SmtpClient("smtp.example.com", 587); // 如 smtp.gmail.com smtpClient.EnableSsl = true; // 启用 SSL/TLS smtpClient.UseDefaultCredentials = false; smtpClient.Credentials = new NetworkCredential(from, password); // 创建邮件 MailMessage mailMessage = new MailMessage(); mailMessage.From = new MailAddress(from); mailMessage.To.Add(to); mailMessage.Subject = subject; mailMessage.Body = body; mailMessage.IsBodyHtml = true; // 支持 HTML 内容 // 添加附件（可选） Attachment attachment = new Attachment("C:/file.pdf"); mailMessage.Attachments.Add(attachment); // 发送邮件 smtpClient.Send(mailMessage); // 清理资源 attachment.Dispose(); } catch (Exception ex) { // 错误处理 Console.WriteLine($"发送失败: {ex.Message}"); } }

注意事项：

• 安全性：避免硬编码密码，使用 ConfigurationManager 或环境变量存储凭据。
• 端口：常用端口 587（TLS）或 465（SSL）。
• 邮箱服务配置：需开启 SMTP 服务（如 Gmail 需启用“安全性较低的应用”或生成应用专用密码）。
• 过时警告：在 .NET Core 3.0+ 中 SmtpClient 已被标记为 [Obsolete]。

方法2：使用 MailKit（推荐跨平台方案）

适用于所有 .NET 版本（包括 .NET Core/5/6+），更安全、高效且支持异步。

安装 NuGet 包：

Install-Package MailKit Install-Package MimeKit

示例代码：

using MimeKit; using MailKit.Net.Smtp; public async Task SendEmailAsync(string to, string subject, string body) { try { var message = new MimeMessage(); message.From.Add(new MailboxAddress("发件人名称", "sender@example.com")); message.To.Add(new MailboxAddress("收件人名称", to)); message.Subject = subject; // 构建邮件内容（支持 HTML + 纯文本） var bodyBuilder = new BodyBuilder(); bodyBuilder.HtmlBody = body; // HTML 内容 bodyBuilder.TextBody = "请使用支持HTML的邮件客户端查看"; // 纯文本回退 message.Body = bodyBuilder.ToMessageBody(); // 添加附件（可选） bodyBuilder.Attachments.Add("C:/file.pdf"); using (var client = new SmtpClient()) { // 连接 SMTP 服务器 await client.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls); // 认证（避免硬编码凭据！） await client.AuthenticateAsync("sender@example.com", "your_password"); // 发送邮件 await client.SendAsync(message); // 断开连接 await client.DisconnectAsync(true); } } catch (Exception ex) { Console.WriteLine($"发送失败: {ex.Message}"); } }

MailKit 优势：

1. 跨平台支持：兼容 .NET Framework/Core/5/6+。
2. 异步操作：原生支持 async/await 避免阻塞。
3. 更安全的协议：支持 SecureSocketOptions（如 StartTls）。
4. 高级功能：更完善的 MIME 处理、附件、邮件头控制等。

关键配置说明

推荐实践：

1. 新项目统一使用 MailKit。
2. 敏感凭据通过 Azure Key Vault、环境变量 或 AppSettings.json 存储。
3. 使用 async/await 提升并发性能。

示例配置存储（appsettings.json）：

{ "EmailSettings": { "SmtpServer": "smtp.example.com", "Port": 587, "Username": "sender@example.com", "Password": "your_secure_password" } }