在 ASP.NET 或 .NET Framework 專案中,發送電子郵件是常見需求。本文整理一個實用的 EmailHelper 靜態類別,封裝了 System.Net.Mail 命名空間的核心功能,支援 HTML 格式、UTF-8 編碼、高優先級等常用設定,開箱即用。
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Net.Mail;
using System.Net;
namespace CLB.Utility.Tools
{
public class EmailHelper
{
///
/// 發送郵件
///
/// 郵件標題
/// 郵件正文
/// 收件人
/// 是否為 HTML 格式
/// 發送成功返回 true,否則 false
public static bool SendMail(string subject, string body, string to, bool isHtml)
{
using (MailMessage msg = new MailMessage())
{
msg.To.Add(to);
// 發件人地址與顯示名稱,請替換為實際 SMTP 帳號
msg.From = new MailAddress("your_email@example.com", "系統通知", Encoding.UTF8);
msg.Subject = subject;
msg.SubjectEncoding = Encoding.UTF8;
msg.Body = body;
msg.BodyEncoding = Encoding.UTF8;
msg.IsBodyHtml = isHtml;
msg.Priority = MailPriority.High;
using (SmtpClient client = new SmtpClient())
{
// SMTP 認證資訊,請替換為實際帳號密碼
client.Credentials = new NetworkCredential("your_email@example.com", "your_password");
client.Host = "smtp.example.com"; // SMTP 伺服器位址
client.Port = 587; // 常用埠號,視供應商而定
client.EnableSsl = true; // 建議啟用 SSL
try
{
client.Send(msg);
return true;
}
catch (Exception ex)
{
// 實際專案建議記錄日誌:ex.Message
return false;
}
}
}
}
}
}
// 簡單文字郵件
bool result = EmailHelper.SendMail(
"測試標題",
"這是純文字內容",
"recipient@example.com",
false
);
// HTML 格式郵件
string htmlBody = @"歡迎註冊
請點擊 驗證連結
";
result = EmailHelper.SendMail("帳號驗證", htmlBody, "user@example.com", true);
appsettings.json 或 web.config,避免硬編碼。SendMailAsync 避免阻塞主執行緒,提升回應速度。| 錯誤現象 | 可能原因 | 解決方向 |
|---|---|---|
| 驗證失敗 | 帳號/密碼錯誤、未開啟「低安全性應用程式存取」 | 確認認證資訊,啟用應用程式專用密碼或 OAuth2 |
| 連線逾時 | 埠號錯誤、防火牆攔截、SSL 設定不符 | 嘗試 25/465/587 埠,確認 EnableSsl 設定 |
| 郵件進垃圾桶 | 缺少 SPF/DKIM/DMARC、內容觸發反垃圾規則 | 配置網域驗證,優化內容,避免過多連結與敏感詞 |
這個 EmailHelper 提供了乾淨、可復用的發送郵件基礎。實際上線前,請務必將敏感資訊移至設定檔,並加入非同步、重試、日誌等生產級特性。若專案已升級至 .NET Core / .NET 5+,建議改用 MailKit 或 MimeKit 以獲得更好的跨平台支援與效能。