萬盛學電腦網

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

ASP.NET 使用 JMail 發送郵件完整指南:SMTP 驗證、附件與異常處理

前言

JMail 是經典的 ASP/ASP.NET 郵件發送組件,雖然現代開發更推薦 System.Net.Mail 或 MailKit,但維護舊專案時仍需了解 JMail 用法。本文詳解配置、發送流程、附件處理與常見問題。

核心屬性與方法速查

屬性/方法說明
Logging啟用日誌記錄,便於除錯
Silenttrue:不拋出異常,發送結果透過返回值判斷
MailServerUserNameSMTP 登入用戶名(完整郵箱地址)
MailServerPassWordSMTP 登入密碼(或應用專用密碼)
From寄件人地址
Subject郵件主題
Body郵件正文(純文本)
HTMLBody郵件正文(HTML 格式)
AddAttachment(path, inline, displayName)添加附件,inline=true 內嵌圖片
AddRecipient(email, name, type)添加收件人,type: TO/CC/BCC
Send(smtpServer, ssl)發送郵件,返回 Boolean

完整發送範例

using JMAIL; // 需引用 JMail 組件

public bool SendMailWithJMail()
{
    try
    {
        MessageClass email = new MessageClass();
        
        // 基礎配置
        email.Logging = true;           // 開啟日誌
        email.Silent = true;            // 不拋出異常,由返回值判斷
        email.MailServerUserName = "sender@163.com";
        email.MailServerPassWord = "your_smtp_password"; // 應用專用密碼
        email.From = "sender@163.com";
        email.Subject = "測試郵件 - " + DateTime.Now.ToString("yyyy-MM-dd HH:mm");
        
        // 正文:支援 HTML
        email.HTMLBody = @"
            

這是一封測試郵件

發送時間:" + DateTime.Now + @"

祝好!

"; // 附件 email.AddAttachment(@"C:\Reports\monthly.pdf", false, "月報.pdf"); email.AddAttachment(@"C:\Images\chart.png", true, "chart.png"); // 內嵌圖片 // 收件人 email.AddRecipient("receiver@example.com", "接收者", "TO"); email.AddRecipient("cc@example.com", "抄送者", "CC"); // 發送:SMTP 伺服器、是否 SSL bool success = email.Send("smtp.163.com", true); // 163 使用 SSL (465/994) if (!success) { // Silent=true 時,可透過 Log 檔案或 LastError 排查 string error = email.LastError; // 獲取最後錯誤描述 LogError($"JMail 發送失敗: {error}"); } return success; } catch (Exception ex) { LogError($"JMail 異常: {ex.Message}"); return false; } }

現代替代方案:System.Net.Mail (內建、無需額外安裝)

using System.Net;
using System.Net.Mail;

public async Task SendMailModernAsync()
{
    try
    {
        using var message = new MailMessage
        {
            From = new MailAddress("sender@163.com", "發送者名稱"),
            Subject = "現代郵件發送測試",
            Body = "

HTML 正文

支援非同步發送

", IsBodyHtml = true, Priority = MailPriority.Normal }; message.To.Add("receiver@example.com"); message.CC.Add("cc@example.com"); message.Attachments.Add(new Attachment(@"C:\Reports\monthly.pdf")); using var client = new SmtpClient("smtp.163.com", 465) // 或 587 (STARTTLS) { Credentials = new NetworkCredential("sender@163.com", "your_smtp_password"), EnableSsl = true, DeliveryMethod = SmtpDeliveryMethod.Network, Timeout = 30000 }; await client.SendMailAsync(message); return true; } catch (SmtpException ex) { LogError($"SMTP 錯誤: {ex.StatusCode} - {ex.Message}"); return false; } catch (Exception ex) { LogError($"發送異常: {ex.Message}"); return false; } }

進階:MailKit(跨平台、功能最強)


// NuGet: MailKit
using MailKit.Net.Smtp;
using MimeKit;

public async Task SendMailWithMailKitAsync()
{
    var message = new MimeMessage();
    message.From.Add(new MailboxAddress("發送者", "sender@163.com"));
    message.To.Add(new MailboxAddress("接收者", "receiver@example.com"));
    message.Subject = "MailKit 郵件測試";
    
    var builder = new BodyBuilder
    {
        HtmlBody = "

MailKit HTML 正文

", TextBody = "純文本備選內容" }; builder.Attachments.Add(@"C:\Reports\monthly.pdf"); message.Body = builder.ToMessageBody(); using var client = new SmtpClient(); await client.ConnectAsync("smtp.163.com", 465, true); // SSL await client.AuthenticateAsync("sender@163.com", "your_smtp_password"); await client.SendAsync(message); await client.DisconnectAsync(true); return true; }

常見問題排查清單

  1. 認證失敗:確認使用「應用專用密碼」而非登入密碼(Gmail、Outlook、163 等均需)
  2. 連接超時:檢查防火牆、端口(25/465/587)、SSL/TLS 設定
  3. 進垃圾箱:配置 SPF/DKIM/DMARC、避免垃圾郵件關鍵詞、使用可信域名
  4. 中文亂碼:確保 `message.SubjectEncoding = Encoding.UTF8`、`message.BodyEncoding = Encoding.UTF8`
  5. 大附件失敗:檢查郵件伺服器大小限制、考慮分片或雲存儲連結

結語

JMail 承載了 ASP 時代的記憶,但新專案請毫猶豫選擇 MailKit(跨平台、功能完整、積極維護)或 System.Net.Mail(零依賴、內建)。核心原理始終是:正確的 SMTP 配置 + 安全的認證 + 異步非阻塞發送 + 完善的錯誤處理與日誌記錄。

copyright © 萬盛學電腦網 all rights reserved