1. 項目概述為什么用Python發郵件是必備技能在自動化辦公和數據監控的日常里自動發送郵件是個高頻需求。無論是定時推送一份數據分析報告還是在服務器異常時第一時間向你的手機發送告警或者批量給用戶發送通知手動去點“發送”按鈕顯然不現實。Python憑借其簡潔的語法和強大的庫生態成了實現這類任務的首選工具。很多人一聽到“編程發郵件”就覺得門檻很高涉及到復雜的網絡協議。其實不然Python標準庫里的smtplib和email模塊已經把SMTP簡單郵件傳輸協議的底層細節封裝得非常友好你只需要關注“誰發”、“發給誰”、“發什么內容”這幾個核心問題。這篇文章我就以一個老開發的身份帶你從零開始手把手搞定用Python發送郵件的全過程從最基礎的文本郵件到帶附件的復雜郵件再到如何避開那些新手常踩的“坑”比如授權碼、端口選擇、編碼問題等。無論你是想給自己的小工具增加一個通知功能還是為公司的自動化流程搭建一個郵件通知模塊這篇指南都能給你一套可直接復用的解決方案。2. 核心原理與準備工作2.1 SMTP協議與Python模塊簡介SMTP是互聯網上發送電子郵件的標準協議你可以把它想象成郵局系統。你的Python程序就是寄件人它需要找到一家“郵局”SMTP服務器把寫好的信郵件內容交給它由它負責投遞到收件人的“郵箱”接收郵件服務器。Python的smtplib模塊就是專門用來和SMTP服務器打交道的“郵遞員”它負責建立連接、身份認證和發送指令。而email模塊則是“信封和信紙”的制造廠它幫你把郵件的發件人、收件人、主題、正文、附件等各部分按照嚴格的格式組裝成一個完整的、SMTP服務器能識別的數據包。這里有一個關鍵點你不能直接用你的郵箱密碼去登錄SMTP服務器。出于安全考慮主流的郵箱服務商如Gmail、QQ郵箱、163郵箱、Outlook都要求使用“授權碼”或“應用專用密碼”。這相當于為你的Python程序單獨生成了一把鑰匙而不是給你家大門的萬能鑰匙。即使這把鑰匙泄露了也不會危及你郵箱賬戶的全部安全。所以第一步永遠是去你的郵箱設置里生成這個授權碼。2.2 環境準備與授權碼獲取你不需要安裝任何額外的第三方庫因為smtplib和email都是Python的標準庫只要你安裝了Python建議3.6以上版本它們就已經就位了。準備工作主要是獲取以下信息SMTP服務器地址和端口不同郵箱服務商不同。常見的有QQ郵箱/QQ企業郵箱smtp.qq.com 使用SSL加密的端口是465 使用TLS加密的端口是587。163/126郵箱smtp.163.com 端口同上。Gmailsmtp.gmail.com 端口587(TLS) 或465(SSL)。Outlook/Hotmailsmtp.office365.com 端口587(TLS)。發件人郵箱賬號你的完整郵箱地址。授權碼App Password這是最關鍵的一步。以QQ郵箱為例登錄網頁版后在“設置”-“賬戶”中找到“POP3/IMAP/SMTP服務”選項開啟服務后會提示你生成授權碼。Gmail用戶需要在Google賬戶的“安全性”設置中開啟“兩步驗證”后才能生成“應用專用密碼”。請務必妥善保管這個16位或其他長度的字符串它就是你的程序密碼。注意千萬不要將授權碼直接硬編碼在提交到公開倉庫的代碼里一個標準的做法是將其存儲在環境變量或本地的配置文件中。例如在代碼所在目錄創建一個.env文件記得加入.gitignore內容為EMAIL_PASSWORD你的授權碼然后在Python中使用os.getenv(EMAIL_PASSWORD)來讀取。3. 從零開始發送第一封純文本郵件讓我們從最簡單的場景開始發送一封只有純文本正文的郵件。這個過程清晰地展示了使用smtplib和email模塊的標準流程。3.1 構建郵件內容對象首先我們需要用email模塊來“撰寫”郵件。MIMEText類專門用于創建文本郵件。from email.mime.text import MIMEText import smtplib # 1. 構建郵件內容 msg MIMEText(你好這是一封來自Python的測試郵件。, plain, utf-8) msg[From] your_emailqq.com # 發件人 msg[To] recipientexample.com # 收件人 msg[Subject] Python郵件測試 # 郵件主題這里有幾個細節MIMEText的第一個參數是郵件正文。第二個參數‘plain’表示這是純文本。如果要發送HTML格式的郵件則改為‘html’。第三個參數‘utf-8’指定編碼確保中文不會亂碼。msg[‘From’]和msg[‘To’]是郵件頭信息它們告訴服務器這封信是誰寄的、要寄給誰。注意‘To’字段可以是一個由逗號分隔的字符串用于發送給多人例如‘aa.com, bb.com’。3.2 連接SMTP服務器并發送郵件“寫”好后就該交給“郵遞員”smtplib了。# 2. 連接SMTP服務器并發送 smtp_server smtp.qq.com smtp_port 465 # 使用SSL加密 from_addr your_emailqq.com password 你的16位QQ郵箱授權碼 # 警告實際使用時請從環境變量讀取 try: # 創建SSL安全連接 server smtplib.SMTP_SSL(smtp_server, smtp_port) # 調試模式會在控制臺打印與服務器的所有通信便于排查問題 server.set_debuglevel(1) # 登錄郵箱賬戶 server.login(from_addr, password) # 發送郵件 # sendmail 參數發件人收件人列表可以是字符串或列表郵件內容as_string()方法將MIME對象轉為字符串 server.sendmail(from_addr, [recipientexample.com], msg.as_string()) print(郵件發送成功) except smtplib.SMTPException as e: print(f郵件發送失敗: {e}) finally: # 關閉連接 server.quit()實操心得端口選擇465端口使用SMTP_SSL在建立連接之初就進行加密而587端口通常先使用SMTP建立普通連接然后通過starttls()方法升級為加密連接。后者更靈活是當前推薦的方式。使用587端口的代碼略有不同server smtplib.SMTP(smtp_server, 587) server.starttls() # 升級為加密連接 server.login(from_addr, password) # ... 后續發送操作相同調試在開發階段將server.set_debuglevel(1)打開非常有用你能看到和服務器“對話”的全過程如果登錄失敗或發送出錯從這些日志里能找到第一手線索。異常處理網絡不穩定、授權碼錯誤、服務器拒絕等都可能導致發送失敗。用try...except包裹核心代碼是生產環境中的基本操作必要時可以加入重試邏輯。4. 進階功能發送HTML郵件與帶附件的郵件只會發純文本郵件顯然不夠用。工作報告需要精美的排版監控周報需要嵌入圖表這些都需要HTML郵件。而發送會議紀要、數據文件等則離不開附件功能。4.1 發送HTML格式郵件發送HTML郵件和發送純文本郵件在步驟上幾乎一樣唯一的區別在于構建MIMEText對象時將第二個參數改為‘html’并將HTML字符串作為正文內容。from email.mime.text import MIMEText html_content !DOCTYPE html html body h2 stylecolor: blue;每周數據報告/h2 p本周系統運行平穩關鍵指標如下/p ul li用戶活躍數 strong15,432/strong/li li訂單成功率 strong99.2%/strong/li li平均響應時間 strong128ms/strong/li /ul p詳情請查看a href\https://your-dashboard.com\內部數據看板/a。/p /body /html msg MIMEText(html_content, html, utf-8) msg[From] from_addr msg[To] to_addr msg[Subject] 【自動化周報】系統運行數據 # ... 后續連接服務器和發送的代碼與之前相同注意事項樣式內聯很多郵件客戶端如Outlook、Gmail網頁版對style標簽或外部CSS支持不佳。為了確保樣式顯示一致最好將CSS樣式以內聯形式style””寫在HTML標簽內部。圖片嵌入如果HTML郵件中有圖片并且希望收件人離線也能查看不能簡單使用網絡圖片鏈接有些郵件客戶端會屏蔽。這時需要將圖片作為附件嵌入Content-ID這涉及到MIMEMultipart和MIMEImage稍顯復雜。對于簡單的報告使用網絡鏈接并做好鏈接失效的備選說明是更務實的做法。4.2 發送帶附件的郵件發送附件需要用到MIMEMultipart類。你可以把它看作一個“混合容器”這個容器里既可以裝文本正文MIMEText也可以裝各種附件MIMEApplication,MIMEImage等。from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.application import MIMEApplication import os # 創建混合類型的郵件主體 msg MIMEMultipart() msg[From] from_addr msg[To] to_addr msg[Subject] 帶附件的測試郵件 - 數據分析報告.pdf # 添加文本正文 text_part MIMEText(您好本次的數據分析報告請查收詳情見附件。, plain, utf-8) msg.attach(text_part) # 添加附件 file_path ./weekly_report.pdf with open(file_path, rb) as f: # MIMEApplication 適合用于二進制文件如pdf, zip, excel等 att MIMEApplication(f.read()) # 為附件添加頭部信息指定文件名 att.add_header(Content-Disposition, attachment, filenameos.path.basename(file_path)) # 可選指定附件類型幫助郵件客戶端識別 att.add_header(Content-Type, application/octet-stream, nameos.path.basename(file_path)) msg.attach(att) # ... 后續連接服務器和發送的代碼與之前相同實操心得文件名編碼如果附件文件名包含中文直接使用os.path.basename可能會導致亂碼。需要對其進行編碼處理。一種常見的方法是使用email.header.Header類from email.header import Header filename Header(‘中文報告.pdf’, ‘utf-8’).encode() att.add_header(‘Content-Disposition’, ‘attachment’, filenamefilename)大附件處理對于非常大的文件一次性讀入內存f.read()可能造成壓力。可以考慮分塊讀取但對于SMTP發送來說通常附件大小會被郵件服務商限制如25MB所以這個問題不常遇到。如果必須發送大文件更常見的做法是上傳到云存儲然后在郵件正文中分享下載鏈接。多個附件只需重復attach操作即可msg.attach(att1),msg.attach(att2)。5. 實戰封裝與高級配置當你掌握了基本操作后為了在多個項目中復用也為了代碼更清晰健壯將其封裝成一個類或函數是必然選擇。同時我們還需要考慮一些生產環境中會遇到的實際問題。5.1 構建一個可復用的郵件發送類下面是一個簡化但功能相對完整的郵件發送類示例import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from email.mime.application import MIMEApplication from email.header import Header import os class EmailSender: def __init__(self, smtp_server, smtp_port, username, password, use_tlsTrue): 初始化郵件發送器 :param smtp_server: SMTP服務器地址 :param smtp_port: 端口 :param username: 發件郵箱 :param password: 授權碼 :param use_tls: 是否使用TLS (端口587)否則使用SSL (端口465) self.smtp_server smtp_server self.smtp_port smtp_port self.username username self.password password self.use_tls use_tls self.server None def connect(self): 建立與SMTP服務器的連接 try: if self.use_tls: self.server smtplib.SMTP(self.smtp_server, self.smtp_port) self.server.starttls() # 升級為TLS加密連接 else: self.server smtplib.SMTP_SSL(self.smtp_server, self.smtp_port) # SSL連接 self.server.login(self.username, self.password) print(SMTP服務器連接成功。) except Exception as e: print(f連接SMTP服務器失敗: {e}) raise def send_email(self, to_addrs, subject, content, content_typeplain, attachmentsNone): 發送郵件 :param to_addrs: 收件人字符串或列表 :param subject: 郵件主題 :param content: 郵件正文內容 :param content_type: 正文類型plain 或 html :param attachments: 附件路徑列表如 [‘./file1.pdf‘, ‘./data.zip’] if not self.server: self.connect() # 創建郵件主體 if attachments: msg MIMEMultipart() # 添加正文部分 text_part MIMEText(content, content_type, utf-8) msg.attach(text_part) else: msg MIMEText(content, content_type, utf-8) # 設置郵件頭 msg[From] self.username msg[To] , .join([to_addrs] if isinstance(to_addrs, str) else to_addrs) msg[Subject] Header(subject, utf-8) # 處理主題中文編碼 # 添加附件 if attachments: for file_path in attachments: if os.path.exists(file_path): with open(file_path, rb) as f: att MIMEApplication(f.read()) # 處理中文文件名 basename os.path.basename(file_path) filename Header(basename, utf-8).encode() att.add_header(Content-Disposition, attachment, filenamefilename) msg.attach(att) else: print(f警告附件文件不存在已跳過 - {file_path}) # 發送郵件 try: self.server.sendmail(self.username, to_addrs, msg.as_string()) print(f郵件發送成功至 {to_addrs}) except Exception as e: print(f郵件發送失敗: {e}) raise def quit(self): 關閉連接 if self.server: self.server.quit() print(SMTP連接已關閉。) # 使用示例 if __name__ __main__: # 配置信息應從環境變量或配置文件中讀取 config { smtp_server: smtp.qq.com, smtp_port: 587, username: your_emailqq.com, password: os.getenv(QQ_EMAIL_PASSWORD), # 從環境變量讀取密碼 use_tls: True, } sender EmailSender(**config) try: sender.connect() # 發送純文本郵件 sender.send_email( to_addrsrecipient1example.com, subject測試純文本, content這是一封純文本測試郵件。 ) # 發送帶HTML和附件的郵件 sender.send_email( to_addrs[recipient1example.com, recipient2example.com], subject周報與數據, contenth1本周總結/h1p詳情見附件。/p, content_typehtml, attachments[./weekly_report.pdf, ./data.xlsx] ) finally: sender.quit()這個類將連接、發送、關閉連接等邏輯封裝起來支持TLS/SSL、HTML、多收件人、多附件并初步處理了中文編碼問題可以直接集成到你的項目中。5.2 異步發送與連接池考量對于需要高頻發送郵件如批量通知的場景同步發送發完一封再發下一封效率太低。此時可以考慮異步發送。但請注意smtplib本身是同步的。實現異步通常有兩種思路多線程/多進程為每一批郵件或每一個發送任務開啟一個獨立的線程或進程。這種方法簡單但線程/進程管理不當會造成資源浪費。可以使用concurrent.futures庫中的ThreadPoolExecutor來管理線程池。異步IOasyncio更現代高效的方式。但smtplib沒有原生異步支持。你可以使用第三方庫如aiosmtplib它提供了異步的SMTP客戶端。代碼模式如下import aiosmtplib from email.message import EmailMessage async def send_async(): message EmailMessage() message[“From”] from_addr message[“To”] to_addr message[“Subject”] “異步測試” message.set_content(“異步發送郵件內容”) await aiosmtplib.send(message, hostname“smtp.qq.com”, port587, usernamefrom_addr, passwordpassword, use_tlsTrue)連接池對于超高頻發送如每分鐘數百封頻繁建立和斷開SMTP連接三次握手、TLS協商開銷巨大。一個優化方案是維護一個持久的SMTP連接池。發送郵件時從池中取出一個已認證的連接用完放回避免重復登錄。這需要更復雜的代碼來管理連接的生命周期、超時和重連。在絕大多數應用場景下每發送一封郵件就建立一次連接是可以接受的。6. 常見問題排查與安全實踐在實際操作中你幾乎一定會遇到一些問題。下面我整理了一份“踩坑”清單和對應的解決方案。6.1 典型錯誤與解決方案速查表錯誤現象或問題可能原因解決方案smtplib.SMTPAuthenticationError: (535, b‘Login Fail’)1. 授權碼錯誤最常見。2. 郵箱未開啟SMTP服務。3. 使用了郵箱登錄密碼而非授權碼。4. 嘗試登錄的賬號與發件人不符。1. 仔細核對并重新生成授權碼。2. 登錄網頁郵箱在設置中開啟POP3/SMTP服務。3. 確認使用的是“授權碼”。4. 確保login用的賬號和msg[‘From’]一致。smtplib.SMTPConnectError或連接超時1. SMTP服務器地址或端口寫錯。2. 網絡問題防火墻、代理。3. 服務器暫時不可用。1. 核對服務商提供的正確地址和端口。2. 嘗試關閉代理或更換網絡。3. 稍后重試。使用server.set_debuglevel(1)查看具體卡在哪一步。ssl.SSLError相關錯誤1. Python版本過舊SSL庫不兼容。2. 系統時間不正確導致SSL證書驗證失敗。1. 升級Python到較新版本如3.7。2. 同步系統時間。臨時可嘗試創建不驗證證書的上下文生產環境不推薦import ssl; context ssl.create_default_context(); context.check_hostname False; context.verify_mode ssl.CERT_NONE然后在SMTP_SSL中傳入contextcontext。郵件發送成功但收不到1. 被收件箱的垃圾郵件規則過濾。2.msg[‘From’]或msg[‘To’]格式錯誤。3. 發送頻率過高被服務商臨時限制。1. 檢查垃圾郵件箱。讓發件人將你的發件地址加入白名單。2. 確保地址是完整的郵箱格式。3. 降低發送頻率或使用具備高信譽度的商業郵件發送服務如SendGrid, Amazon SES。郵件正文或附件名中文亂碼未正確指定編碼。1. 在創建MIMEText或設置Header時明確指定charset‘utf-8’。2. 對中文文件名使用email.header.Header進行編碼。Gmail發送失敗提示“安全性較低的應用的訪問權限”Gmail默認阻止被認為“安全性較低”的應用登錄。1. 不推薦在Google賬戶設置中允許“安全性較低的應用”訪問。2. 推薦按照Gmail要求開啟“兩步驗證”然后使用生成的16位“應用專用密碼”進行登錄。6.2 安全與最佳實踐絕不要硬編碼密碼這是最重要的安全準則。將授權碼存儲在環境變量、專用的配置文件如config.yaml、.env或密鑰管理服務中。在代碼中通過os.environ.get(‘KEY’)來讀取。使用TLS加密優先使用587端口和starttls()方法這是更現代、更受推薦的加密方式。限制發送頻率和量個人郵箱的SMTP服務通常有每日發送上限如QQ郵箱是每天500封且短時間內高頻發送極易被判定為垃圾郵件甚至封號。對于營銷或大量通知請使用專業的郵件發送服務ESPs。設置合適的郵件頭可以設置Message-ID、Date等頭信息讓你的郵件更規范。對于批量發送合理使用Bcc密送而非To或Cc可以保護收件人隱私。處理退信Bounce在生產環境中部分郵件會因地址無效、郵箱已滿等原因被退回。成熟的郵件發送系統需要監聽和處理這些退信通知通常涉及解析返回的DSN投遞狀態通知郵件這是一個相對高級的話題。代碼健壯性加入重試機制例如使用tenacity庫、超時設置和詳細的日志記錄確保在臨時網絡波動或服務短暫不可用時程序能優雅地處理而非直接崩潰。通過以上步驟你不僅能夠實現Python發送郵件的基礎功能更能構建一個健壯、可維護、安全的郵件發送模塊從容應對各種實際開發場景。記住關鍵不在于記住所有參數而在于理解SMTP通信的基本模型和email庫構建MIME消息的邏輯這樣無論遇到什么需求你都能快速找到解決方案。 Python自動化郵件發送全攻略：從SMTP原理到實戰封裝
1. 項目概述為什么用Python發郵件是必備技能在自動化辦公和數據監控的日常里自動發送郵件是個高頻需求。無論是定時推送一份數據分析報告還是在服務器異常時第一時間向你的手機發送告警或者批量給用戶發送通知手動去點“發送”按鈕顯然不現實。Python憑借其簡潔的語法和強大的庫生態成了實現這類任務的首選工具。很多人一聽到“編程發郵件”就覺得門檻很高涉及到復雜的網絡協議。其實不然Python標準庫里的smtplib和email模塊已經把SMTP簡單郵件傳輸協議的底層細節封裝得非常友好你只需要關注“誰發”、“發給誰”、“發什么內容”這幾個核心問題。這篇文章我就以一個老開發的身份帶你從零開始手把手搞定用Python發送郵件的全過程從最基礎的文本郵件到帶附件的復雜郵件再到如何避開那些新手常踩的“坑”比如授權碼、端口選擇、編碼問題等。無論你是想給自己的小工具增加一個通知功能還是為公司的自動化流程搭建一個郵件通知模塊這篇指南都能給你一套可直接復用的解決方案。2. 核心原理與準備工作2.1 SMTP協議與Python模塊簡介SMTP是互聯網上發送電子郵件的標準協議你可以把它想象成郵局系統。你的Python程序就是寄件人它需要找到一家“郵局”SMTP服務器把寫好的信郵件內容交給它由它負責投遞到收件人的“郵箱”接收郵件服務器。Python的smtplib模塊就是專門用來和SMTP服務器打交道的“郵遞員”它負責建立連接、身份認證和發送指令。而email模塊則是“信封和信紙”的制造廠它幫你把郵件的發件人、收件人、主題、正文、附件等各部分按照嚴格的格式組裝成一個完整的、SMTP服務器能識別的數據包。這里有一個關鍵點你不能直接用你的郵箱密碼去登錄SMTP服務器。出于安全考慮主流的郵箱服務商如Gmail、QQ郵箱、163郵箱、Outlook都要求使用“授權碼”或“應用專用密碼”。這相當于為你的Python程序單獨生成了一把鑰匙而不是給你家大門的萬能鑰匙。即使這把鑰匙泄露了也不會危及你郵箱賬戶的全部安全。所以第一步永遠是去你的郵箱設置里生成這個授權碼。2.2 環境準備與授權碼獲取你不需要安裝任何額外的第三方庫因為smtplib和email都是Python的標準庫只要你安裝了Python建議3.6以上版本它們就已經就位了。準備工作主要是獲取以下信息SMTP服務器地址和端口不同郵箱服務商不同。常見的有QQ郵箱/QQ企業郵箱smtp.qq.com 使用SSL加密的端口是465 使用TLS加密的端口是587。163/126郵箱smtp.163.com 端口同上。Gmailsmtp.gmail.com 端口587(TLS) 或465(SSL)。Outlook/Hotmailsmtp.office365.com 端口587(TLS)。發件人郵箱賬號你的完整郵箱地址。授權碼App Password這是最關鍵的一步。以QQ郵箱為例登錄網頁版后在“設置”-“賬戶”中找到“POP3/IMAP/SMTP服務”選項開啟服務后會提示你生成授權碼。Gmail用戶需要在Google賬戶的“安全性”設置中開啟“兩步驗證”后才能生成“應用專用密碼”。請務必妥善保管這個16位或其他長度的字符串它就是你的程序密碼。注意千萬不要將授權碼直接硬編碼在提交到公開倉庫的代碼里一個標準的做法是將其存儲在環境變量或本地的配置文件中。例如在代碼所在目錄創建一個.env文件記得加入.gitignore內容為EMAIL_PASSWORD你的授權碼然后在Python中使用os.getenv(EMAIL_PASSWORD)來讀取。3. 從零開始發送第一封純文本郵件讓我們從最簡單的場景開始發送一封只有純文本正文的郵件。這個過程清晰地展示了使用smtplib和email模塊的標準流程。3.1 構建郵件內容對象首先我們需要用email模塊來“撰寫”郵件。MIMEText類專門用于創建文本郵件。from email.mime.text import MIMEText import smtplib # 1. 構建郵件內容 msg MIMEText(你好這是一封來自Python的測試郵件。, plain, utf-8) msg[From] your_emailqq.com # 發件人 msg[To] recipientexample.com # 收件人 msg[Subject] Python郵件測試 # 郵件主題這里有幾個細節MIMEText的第一個參數是郵件正文。第二個參數‘plain’表示這是純文本。如果要發送HTML格式的郵件則改為‘html’。第三個參數‘utf-8’指定編碼確保中文不會亂碼。msg[‘From’]和msg[‘To’]是郵件頭信息它們告訴服務器這封信是誰寄的、要寄給誰。注意‘To’字段可以是一個由逗號分隔的字符串用于發送給多人例如‘aa.com, bb.com’。3.2 連接SMTP服務器并發送郵件“寫”好后就該交給“郵遞員”smtplib了。# 2. 連接SMTP服務器并發送 smtp_server smtp.qq.com smtp_port 465 # 使用SSL加密 from_addr your_emailqq.com password 你的16位QQ郵箱授權碼 # 警告實際使用時請從環境變量讀取 try: # 創建SSL安全連接 server smtplib.SMTP_SSL(smtp_server, smtp_port) # 調試模式會在控制臺打印與服務器的所有通信便于排查問題 server.set_debuglevel(1) # 登錄郵箱賬戶 server.login(from_addr, password) # 發送郵件 # sendmail 參數發件人收件人列表可以是字符串或列表郵件內容as_string()方法將MIME對象轉為字符串 server.sendmail(from_addr, [recipientexample.com], msg.as_string()) print(郵件發送成功) except smtplib.SMTPException as e: print(f郵件發送失敗: {e}) finally: # 關閉連接 server.quit()實操心得端口選擇465端口使用SMTP_SSL在建立連接之初就進行加密而587端口通常先使用SMTP建立普通連接然后通過starttls()方法升級為加密連接。后者更靈活是當前推薦的方式。使用587端口的代碼略有不同server smtplib.SMTP(smtp_server, 587) server.starttls() # 升級為加密連接 server.login(from_addr, password) # ... 后續發送操作相同調試在開發階段將server.set_debuglevel(1)打開非常有用你能看到和服務器“對話”的全過程如果登錄失敗或發送出錯從這些日志里能找到第一手線索。異常處理網絡不穩定、授權碼錯誤、服務器拒絕等都可能導致發送失敗。用try...except包裹核心代碼是生產環境中的基本操作必要時可以加入重試邏輯。4. 進階功能發送HTML郵件與帶附件的郵件只會發純文本郵件顯然不夠用。工作報告需要精美的排版監控周報需要嵌入圖表這些都需要HTML郵件。而發送會議紀要、數據文件等則離不開附件功能。4.1 發送HTML格式郵件發送HTML郵件和發送純文本郵件在步驟上幾乎一樣唯一的區別在于構建MIMEText對象時將第二個參數改為‘html’并將HTML字符串作為正文內容。from email.mime.text import MIMEText html_content !DOCTYPE html html body h2 stylecolor: blue;每周數據報告/h2 p本周系統運行平穩關鍵指標如下/p ul li用戶活躍數 strong15,432/strong/li li訂單成功率 strong99.2%/strong/li li平均響應時間 strong128ms/strong/li /ul p詳情請查看a href\https://your-dashboard.com\內部數據看板/a。/p /body /html msg MIMEText(html_content, html, utf-8) msg[From] from_addr msg[To] to_addr msg[Subject] 【自動化周報】系統運行數據 # ... 后續連接服務器和發送的代碼與之前相同注意事項樣式內聯很多郵件客戶端如Outlook、Gmail網頁版對style標簽或外部CSS支持不佳。為了確保樣式顯示一致最好將CSS樣式以內聯形式style””寫在HTML標簽內部。圖片嵌入如果HTML郵件中有圖片并且希望收件人離線也能查看不能簡單使用網絡圖片鏈接有些郵件客戶端會屏蔽。這時需要將圖片作為附件嵌入Content-ID這涉及到MIMEMultipart和MIMEImage稍顯復雜。對于簡單的報告使用網絡鏈接并做好鏈接失效的備選說明是更務實的做法。4.2 發送帶附件的郵件發送附件需要用到MIMEMultipart類。你可以把它看作一個“混合容器”這個容器里既可以裝文本正文MIMEText也可以裝各種附件MIMEApplication,MIMEImage等。from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.application import MIMEApplication import os # 創建混合類型的郵件主體 msg MIMEMultipart() msg[From] from_addr msg[To] to_addr msg[Subject] 帶附件的測試郵件 - 數據分析報告.pdf # 添加文本正文 text_part MIMEText(您好本次的數據分析報告請查收詳情見附件。, plain, utf-8) msg.attach(text_part) # 添加附件 file_path ./weekly_report.pdf with open(file_path, rb) as f: # MIMEApplication 適合用于二進制文件如pdf, zip, excel等 att MIMEApplication(f.read()) # 為附件添加頭部信息指定文件名 att.add_header(Content-Disposition, attachment, filenameos.path.basename(file_path)) # 可選指定附件類型幫助郵件客戶端識別 att.add_header(Content-Type, application/octet-stream, nameos.path.basename(file_path)) msg.attach(att) # ... 后續連接服務器和發送的代碼與之前相同實操心得文件名編碼如果附件文件名包含中文直接使用os.path.basename可能會導致亂碼。需要對其進行編碼處理。一種常見的方法是使用email.header.Header類from email.header import Header filename Header(‘中文報告.pdf’, ‘utf-8’).encode() att.add_header(‘Content-Disposition’, ‘attachment’, filenamefilename)大附件處理對于非常大的文件一次性讀入內存f.read()可能造成壓力。可以考慮分塊讀取但對于SMTP發送來說通常附件大小會被郵件服務商限制如25MB所以這個問題不常遇到。如果必須發送大文件更常見的做法是上傳到云存儲然后在郵件正文中分享下載鏈接。多個附件只需重復attach操作即可msg.attach(att1),msg.attach(att2)。5. 實戰封裝與高級配置當你掌握了基本操作后為了在多個項目中復用也為了代碼更清晰健壯將其封裝成一個類或函數是必然選擇。同時我們還需要考慮一些生產環境中會遇到的實際問題。5.1 構建一個可復用的郵件發送類下面是一個簡化但功能相對完整的郵件發送類示例import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from email.mime.application import MIMEApplication from email.header import Header import os class EmailSender: def __init__(self, smtp_server, smtp_port, username, password, use_tlsTrue): 初始化郵件發送器 :param smtp_server: SMTP服務器地址 :param smtp_port: 端口 :param username: 發件郵箱 :param password: 授權碼 :param use_tls: 是否使用TLS (端口587)否則使用SSL (端口465) self.smtp_server smtp_server self.smtp_port smtp_port self.username username self.password password self.use_tls use_tls self.server None def connect(self): 建立與SMTP服務器的連接 try: if self.use_tls: self.server smtplib.SMTP(self.smtp_server, self.smtp_port) self.server.starttls() # 升級為TLS加密連接 else: self.server smtplib.SMTP_SSL(self.smtp_server, self.smtp_port) # SSL連接 self.server.login(self.username, self.password) print(SMTP服務器連接成功。) except Exception as e: print(f連接SMTP服務器失敗: {e}) raise def send_email(self, to_addrs, subject, content, content_typeplain, attachmentsNone): 發送郵件 :param to_addrs: 收件人字符串或列表 :param subject: 郵件主題 :param content: 郵件正文內容 :param content_type: 正文類型plain 或 html :param attachments: 附件路徑列表如 [‘./file1.pdf‘, ‘./data.zip’] if not self.server: self.connect() # 創建郵件主體 if attachments: msg MIMEMultipart() # 添加正文部分 text_part MIMEText(content, content_type, utf-8) msg.attach(text_part) else: msg MIMEText(content, content_type, utf-8) # 設置郵件頭 msg[From] self.username msg[To] , .join([to_addrs] if isinstance(to_addrs, str) else to_addrs) msg[Subject] Header(subject, utf-8) # 處理主題中文編碼 # 添加附件 if attachments: for file_path in attachments: if os.path.exists(file_path): with open(file_path, rb) as f: att MIMEApplication(f.read()) # 處理中文文件名 basename os.path.basename(file_path) filename Header(basename, utf-8).encode() att.add_header(Content-Disposition, attachment, filenamefilename) msg.attach(att) else: print(f警告附件文件不存在已跳過 - {file_path}) # 發送郵件 try: self.server.sendmail(self.username, to_addrs, msg.as_string()) print(f郵件發送成功至 {to_addrs}) except Exception as e: print(f郵件發送失敗: {e}) raise def quit(self): 關閉連接 if self.server: self.server.quit() print(SMTP連接已關閉。) # 使用示例 if __name__ __main__: # 配置信息應從環境變量或配置文件中讀取 config { smtp_server: smtp.qq.com, smtp_port: 587, username: your_emailqq.com, password: os.getenv(QQ_EMAIL_PASSWORD), # 從環境變量讀取密碼 use_tls: True, } sender EmailSender(**config) try: sender.connect() # 發送純文本郵件 sender.send_email( to_addrsrecipient1example.com, subject測試純文本, content這是一封純文本測試郵件。 ) # 發送帶HTML和附件的郵件 sender.send_email( to_addrs[recipient1example.com, recipient2example.com], subject周報與數據, contenth1本周總結/h1p詳情見附件。/p, content_typehtml, attachments[./weekly_report.pdf, ./data.xlsx] ) finally: sender.quit()這個類將連接、發送、關閉連接等邏輯封裝起來支持TLS/SSL、HTML、多收件人、多附件并初步處理了中文編碼問題可以直接集成到你的項目中。5.2 異步發送與連接池考量對于需要高頻發送郵件如批量通知的場景同步發送發完一封再發下一封效率太低。此時可以考慮異步發送。但請注意smtplib本身是同步的。實現異步通常有兩種思路多線程/多進程為每一批郵件或每一個發送任務開啟一個獨立的線程或進程。這種方法簡單但線程/進程管理不當會造成資源浪費。可以使用concurrent.futures庫中的ThreadPoolExecutor來管理線程池。異步IOasyncio更現代高效的方式。但smtplib沒有原生異步支持。你可以使用第三方庫如aiosmtplib它提供了異步的SMTP客戶端。代碼模式如下import aiosmtplib from email.message import EmailMessage async def send_async(): message EmailMessage() message[“From”] from_addr message[“To”] to_addr message[“Subject”] “異步測試” message.set_content(“異步發送郵件內容”) await aiosmtplib.send(message, hostname“smtp.qq.com”, port587, usernamefrom_addr, passwordpassword, use_tlsTrue)連接池對于超高頻發送如每分鐘數百封頻繁建立和斷開SMTP連接三次握手、TLS協商開銷巨大。一個優化方案是維護一個持久的SMTP連接池。發送郵件時從池中取出一個已認證的連接用完放回避免重復登錄。這需要更復雜的代碼來管理連接的生命周期、超時和重連。在絕大多數應用場景下每發送一封郵件就建立一次連接是可以接受的。6. 常見問題排查與安全實踐在實際操作中你幾乎一定會遇到一些問題。下面我整理了一份“踩坑”清單和對應的解決方案。6.1 典型錯誤與解決方案速查表錯誤現象或問題可能原因解決方案smtplib.SMTPAuthenticationError: (535, b‘Login Fail’)1. 授權碼錯誤最常見。2. 郵箱未開啟SMTP服務。3. 使用了郵箱登錄密碼而非授權碼。4. 嘗試登錄的賬號與發件人不符。1. 仔細核對并重新生成授權碼。2. 登錄網頁郵箱在設置中開啟POP3/SMTP服務。3. 確認使用的是“授權碼”。4. 確保login用的賬號和msg[‘From’]一致。smtplib.SMTPConnectError或連接超時1. SMTP服務器地址或端口寫錯。2. 網絡問題防火墻、代理。3. 服務器暫時不可用。1. 核對服務商提供的正確地址和端口。2. 嘗試關閉代理或更換網絡。3. 稍后重試。使用server.set_debuglevel(1)查看具體卡在哪一步。ssl.SSLError相關錯誤1. Python版本過舊SSL庫不兼容。2. 系統時間不正確導致SSL證書驗證失敗。1. 升級Python到較新版本如3.7。2. 同步系統時間。臨時可嘗試創建不驗證證書的上下文生產環境不推薦import ssl; context ssl.create_default_context(); context.check_hostname False; context.verify_mode ssl.CERT_NONE然后在SMTP_SSL中傳入contextcontext。郵件發送成功但收不到1. 被收件箱的垃圾郵件規則過濾。2.msg[‘From’]或msg[‘To’]格式錯誤。3. 發送頻率過高被服務商臨時限制。1. 檢查垃圾郵件箱。讓發件人將你的發件地址加入白名單。2. 確保地址是完整的郵箱格式。3. 降低發送頻率或使用具備高信譽度的商業郵件發送服務如SendGrid, Amazon SES。郵件正文或附件名中文亂碼未正確指定編碼。1. 在創建MIMEText或設置Header時明確指定charset‘utf-8’。2. 對中文文件名使用email.header.Header進行編碼。Gmail發送失敗提示“安全性較低的應用的訪問權限”Gmail默認阻止被認為“安全性較低”的應用登錄。1. 不推薦在Google賬戶設置中允許“安全性較低的應用”訪問。2. 推薦按照Gmail要求開啟“兩步驗證”然后使用生成的16位“應用專用密碼”進行登錄。6.2 安全與最佳實踐絕不要硬編碼密碼這是最重要的安全準則。將授權碼存儲在環境變量、專用的配置文件如config.yaml、.env或密鑰管理服務中。在代碼中通過os.environ.get(‘KEY’)來讀取。使用TLS加密優先使用587端口和starttls()方法這是更現代、更受推薦的加密方式。限制發送頻率和量個人郵箱的SMTP服務通常有每日發送上限如QQ郵箱是每天500封且短時間內高頻發送極易被判定為垃圾郵件甚至封號。對于營銷或大量通知請使用專業的郵件發送服務ESPs。設置合適的郵件頭可以設置Message-ID、Date等頭信息讓你的郵件更規范。對于批量發送合理使用Bcc密送而非To或Cc可以保護收件人隱私。處理退信Bounce在生產環境中部分郵件會因地址無效、郵箱已滿等原因被退回。成熟的郵件發送系統需要監聽和處理這些退信通知通常涉及解析返回的DSN投遞狀態通知郵件這是一個相對高級的話題。代碼健壯性加入重試機制例如使用tenacity庫、超時設置和詳細的日志記錄確保在臨時網絡波動或服務短暫不可用時程序能優雅地處理而非直接崩潰。通過以上步驟你不僅能夠實現Python發送郵件的基礎功能更能構建一個健壯、可維護、安全的郵件發送模塊從容應對各種實際開發場景。記住關鍵不在于記住所有參數而在于理解SMTP通信的基本模型和email庫構建MIME消息的邏輯這樣無論遇到什么需求你都能快速找到解決方案。