萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# EmailHelper 郵件發送模組完整實作指南

前言

在 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);

進階建議

  • 設定檔管理:將 SMTP 伺服器、帳號、密碼、埠號、SSL 等參數存放在 appsettings.json 或 web.config,避免硬編碼。
  • 非同步發送:改用 SendMailAsync 避免阻塞主執行緒,提升回應速度。
  • 重試機制:結合 Polly 等庫實現指數退避重試,應對暫時性網路故障。
  • 模板引擎:搭配 RazorLight 或 Scriban 實現郵件模板化,分離內容與邏輯。
  • 日誌與監控:記錄發送成功/失敗、耗時、錯誤詳情,便於事後追蹤。

常見問題排查

錯誤現象可能原因解決方向
驗證失敗帳號/密碼錯誤、未開啟「低安全性應用程式存取」確認認證資訊,啟用應用程式專用密碼或 OAuth2
連線逾時埠號錯誤、防火牆攔截、SSL 設定不符嘗試 25/465/587 埠,確認 EnableSsl 設定
郵件進垃圾桶缺少 SPF/DKIM/DMARC、內容觸發反垃圾規則配置網域驗證,優化內容,避免過多連結與敏感詞

總結

這個 EmailHelper 提供了乾淨、可復用的發送郵件基礎。實際上線前,請務必將敏感資訊移至設定檔,並加入非同步、重試、日誌等生產級特性。若專案已升級至 .NET Core / .NET 5+,建議改用 MailKit 或 MimeKit 以獲得更好的跨平台支援與效能。

copyright © 萬盛學電腦網 all rights reserved