萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> .NET 程式設計

C# 主控台程式發送郵件含附件:SmtpClient 完整實作與避坑指南

背景:大量郵件發送遭封鎖,改用定時任務附件寄送報表

公司因發送大量相同內容郵件被國際反垃圾組織列入黑名單,導致客戶收不到信。解決方案:改為定時任務將查詢結果打包成附件,由主控台程式定時寄送,降低單封郵件體積與頻率。

核心程式碼結構

using System;
using System.Net;
using System.Net.Mail;
using System.Net.Mime;
using System.Collections;

namespace SendEmail {
    class Program {
        static void Main(string[] args) {
            Console.WriteLine(SendEmailWithAttachment());
            Console.ReadKey();
        }

        public static string SendEmailWithAttachment() {
            // === 郵件伺服器設定 (請替換為實際值) ===
            string smtpServer = "***.***.***.***"; // SMTP IP/主機名
            int smtpPort = 25;                     // 或 587 (TLS), 465 (SSL)
            string from = "sender@company.com";
            string to = "receiver@client.com";
            string cc = "cc@company.com";
            string subject = "每日報表 - " + DateTime.Now.ToString("yyyy-MM-dd");
            string body = "您好,附件為今日業務報表,請查收。";

            // === 建立郵件物件 ===
            MailMessage mail = new MailMessage();
            mail.From = new MailAddress(from);
            mail.To.Add(to);
            if (!string.IsNullOrEmpty(cc)) mail.CC.Add(cc);
            mail.Subject = subject;
            mail.SubjectEncoding = System.Text.Encoding.UTF8;
            mail.Body = body;
            mail.BodyEncoding = System.Text.Encoding.UTF8;
            mail.IsBodyHtml = false; // 純文字;HTML 郵件設 true 並調整 Body

            // === 加入附件 ===
            string attachmentPath = @"D:\Reports\DailyReport_" + DateTime.Now.ToString("yyyyMMdd") + ".xlsx";
            if (System.IO.File.Exists(attachmentPath)) {
                Attachment att = new Attachment(attachmentPath, MediaTypeNames.Application.Octet);
                // 解決中文檔名亂碼 (RFC 2231)
                att.ContentDisposition.FileName = System.Net.Mime.MimeUtility.Encode(att.Name);
                mail.Attachments.Add(att);
            }

            // === SMTP 客戶端設定 ===
            SmtpClient client = new SmtpClient(smtpServer, smtpPort) {
                // 若需認證
                // Credentials = new NetworkCredential("account", "password"),
                // EnableSsl = true, // 587/465 埠通常需啟用
                // DeliveryMethod = SmtpDeliveryMethod.Network,
                // Timeout = 30000
            };

            try {
                client.Send(mail);
                return "郵件發送成功:" + DateTime.Now;
            } catch (SmtpException ex) {
                return "SMTP 錯誤:" + ex.StatusCode + " - " + ex.Message;
            } catch (Exception ex) {
                return "發送失敗:" + ex.Message;
            } finally {
                mail.Dispose();
                client.Dispose();
            }
        }
    }
}

關鍵設定說明

屬性用途常見值
EnableSsl啟用 SSL/TLS 加密true (Gmail/Outlook/企業郵箱多要求)
Port連接埠25(無加密), 587(STARTTLS), 465(SSL)
Credentials驗證憑證new NetworkCredential("user", "pwd")
DeliveryMethod投遞方式Network (預設), SpecifiedPickupDirectory
Timeout逾時毫秒30000 (30秒)

附件中文檔名解碼問題

// 錯誤:中文檔名在某些郵件客戶端顯示亂碼
Attachment att = new Attachment(path);

// 正確:使用 MimeUtility.Encode 進行 RFC 2231 編碼
att.ContentDisposition.FileName = MimeUtility.Encode(Path.GetFileName(path));

常見錯誤與解決

  • 5.7.1 Unable to relay:SMTP 未開放轉發,需在郵件伺服器設定允許該 IP 轉發,或使用認證帳號
  • Timeout:防火牆封鎖埠、SSL/TLS 協定不匹配、伺服器回應慢 → 增加 Timeout、檢查防火牆、嘗試 Telnet 測試連線
  • 附件過大被退信:壓縮檔案、分卷壓縮、改用雲端分享連結
  • 編碼問題:統一使用 UTF-8,Subject/Body/附件檔名皆指定 Encoding.UTF8

生產環境建議

  1. 設定檔化:SMTP 參數、收發人清單存 app.config / appsettings.json
  2. 記錄日誌:使用 Serilog/NLog 記錄發送結果、錯誤詳情
  3. 重試機制:Polly 實作指數退避重試
  4. 非同步發送:await client.SendMailAsync(mail) 避免阻塞
  5. 郵件佇列:大量寄送採用資料表佇列 + 背景服務 (BackgroundService) 處理

此主控台程式可直接編譯為 .exe,配合 Windows 排程器或 SQL Server Agent 定時執行,實現自動化報表寄送。

copyright © 萬盛學電腦網 all rights reserved