1. 为什么选择Gmail的SMTP服务

在C#项目中实现邮件发送功能时，选择Gmail的SMTP服务有几个显著优势。首先是可靠性，Gmail作为全球最大的邮件服务提供商之一，其服务器稳定性和送达率都经过充分验证。其次是免费额度足够个人开发者和小型项目使用 - 每天可以发送100封邮件，这对于大多数开发测试场景完全够用。

Gmail SMTP使用标准的587端口（TLS加密）或465端口（SSL加密），这两种都是业界广泛支持的协议。相比自建邮件服务器，省去了维护成本和被识别为垃圾邮件的风险。我在多个生产项目中采用这种方案，实测在国内外网络环境下都能稳定工作。

重要提示：从2022年5月30日起，Google要求所有使用"安全性较低的应用"访问Gmail账户时必须启用两步验证并创建应用专用密码。这是使用Gmail SMTP的前提条件。

2. 环境准备与基础配置

2.1 创建应用专用密码

1. 登录你的Google账户，进入 安全设置页面
2. 启用"两步验证"（如果尚未启用）
3. 在"应用专用密码"部分，选择"邮件"应用类型，生成一个16位的密码
4. 妥善保存这个密码，它将在代码中替代你的常规密码

2.2 必要的C#库

对于.NET项目，我们有两种主流选择：

1. System.Net.Mail：.NET Framework自带的库，无需额外安装
2. MailKit：更现代的第三方库，支持更多高级功能

我推荐使用MailKit，因为它：

• 支持最新的协议标准
• 对附件处理更友好
• 有更清晰的错误提示
• 活跃维护中

通过NuGet安装MailKit：

dotnet add package MailKit dotnet add package MimeKit

3. 完整实现代码与解析

3.1 基础邮件发送

using MailKit.Net.Smtp; using MimeKit; using System; public class GmailSender { public static void SendEmail(string toAddress, string subject, string body) { try { var message = new MimeMessage(); // 发件人地址必须与认证的Gmail账户一致 message.From.Add(new MailboxAddress("发件人名称", "your@gmail.com")); message.To.Add(new MailboxAddress("", toAddress)); message.Subject = subject; // 构建邮件正文 var bodyBuilder = new BodyBuilder(); bodyBuilder.TextBody = body; // 纯文本版本 bodyBuilder.HtmlBody = $"<p>{body}</p>"; // HTML版本 message.Body = bodyBuilder.ToMessageBody(); using (var client = new SmtpClient()) { // 587端口用于TLS加密 client.Connect("smtp.gmail.com", 587, false); // 使用应用专用密码而非账户密码 client.Authenticate("your@gmail.com", "your-app-specific-password"); client.Send(message); client.Disconnect(true); Console.WriteLine("邮件发送成功"); } } catch (Exception ex) { Console.WriteLine($"发送失败: {ex.Message}"); // 实际项目中应记录完整异常信息 // Logger.Error(ex, "邮件发送异常"); } } }

3.2 添加附件支持

public static void SendWithAttachments(string toAddress, string[] filePaths) { var message = new MimeMessage(); message.From.Add(new MailboxAddress("", "your@gmail.com")); message.To.Add(new MailboxAddress("", toAddress)); message.Subject = "带附件的测试邮件"; var builder = new BodyBuilder(); builder.TextBody = "请查看附件"; // 添加多个附件 foreach (var filePath in filePaths) { if (File.Exists(filePath)) { builder.Attachments.Add(filePath); } } message.Body = builder.ToMessageBody(); using (var client = new SmtpClient()) { client.Connect("smtp.gmail.com", 587, false); client.Authenticate("your@gmail.com", "your-app-specific-password"); client.Send(message); client.Disconnect(true); } }

3.3 异步发送实现

对于需要提高响应速度的应用，建议使用异步版本：

public static async Task SendEmailAsync(string toAddress, string subject, string body) { var message = new MimeMessage(); message.From.Add(new MailboxAddress("", "your@gmail.com")); message.To.Add(new MailboxAddress("", toAddress)); message.Subject = subject; message.Body = new TextPart("plain") { Text = body }; using (var client = new SmtpClient()) { await client.ConnectAsync("smtp.gmail.com", 587, false); await client.AuthenticateAsync("your@gmail.com", "your-app-specific-password"); await client.SendAsync(message); await client.DisconnectAsync(true); } }

4. 常见问题与解决方案

4.1 认证失败错误

错误现象：

Authentication failed: 535 5.7.8 Username and Password not accepted

解决方案：

1. 确认已启用两步验证
2. 使用应用专用密码而非账户密码
3. 检查发件人地址与认证地址完全一致（包括大小写）

4.2 连接超时问题

错误现象：

System.Net.Sockets.SocketException: A connection attempt failed

可能原因：

• 防火墙/杀毒软件阻止了连接
• ISP屏蔽了SMTP端口
• Gmail服务器临时不可用

排查步骤：

1. 尝试telnet测试连通性：

   telnet smtp.gmail.com 587

2. 如果失败，尝试使用465端口（SSL）：

   client.Connect("smtp.gmail.com", 465, true);

3. 检查网络代理设置

4.3 邮件被标记为垃圾邮件

预防措施：

• 在邮件头添加重要头信息：

  message.Headers.Add("Precedence", "bulk"); message.Headers.Add("X-Priority", "3"); // 普通优先级

• 避免使用夸张的标题和内容
• 控制发送频率（Gmail限制为每分钟约20封）

5. 生产环境最佳实践

5.1 配置管理

不要将SMTP凭证硬编码在代码中，推荐使用以下方式之一：

• ASP.NET Core的机密管理器：

  dotnet user-secrets set "Gmail:SmtpPassword" "your-password"

• 环境变量
• 专业的配置服务如Azure Key Vault

5.2 重试机制

网络不稳定时实现自动重试：

public static async Task SendWithRetryAsync(MimeMessage message, int maxRetries = 3) { int retryCount = 0; while (retryCount < maxRetries) { try { using (var client = new SmtpClient()) { await client.ConnectAsync("smtp.gmail.com", 587, false); await client.AuthenticateAsync( Configuration["Gmail:Username"], Configuration["Gmail:Password"]); await client.SendAsync(message); await client.DisconnectAsync(true); return; } } catch (SmtpCommandException ex) when (ex.StatusCode == SmtpStatusCode.ServiceNotAvailable) { retryCount++; if (retryCount >= maxRetries) throw; await Task.Delay(1000 * retryCount); // 指数退避 } } }

5.3 性能优化

批量发送邮件时：

1. 复用SmtpClient连接（但注意不要保持过久）
2. 并行处理时控制并发量
3. 考虑使用邮件队列服务（如Azure Queue Storage）解耦

// 批量发送示例 public static async Task SendBulkEmailsAsync(IEnumerable<MailItem> mailItems) { using (var client = new SmtpClient()) { await client.ConnectAsync("smtp.gmail.com", 587, false); await client.AuthenticateAsync("your@gmail.com", "your-password"); var tasks = mailItems.Select(async item => { var message = new MimeMessage(); // 构建message... await client.SendAsync(message); }); await Task.WhenAll(tasks); await client.DisconnectAsync(true); } }

6. 替代方案比较

当Gmail SMTP不满足需求时，可以考虑：

我在实际项目中选择的经验是：

• 内部系统通知：Gmail SMTP足够
• 用户注册邮件：SendGrid或Mailgun更可靠
• 大规模发送：AWS SES性价比最高