python可通过smtplib和email模块实现邮件自动化，支持纯文本、html及附件发送，需正确配置SMTP服务器、使用授权码认证，并通过异常处理、日志记录与重试机制提升系统健壮性。
说起自动化，邮件发送绝对是日常工作中一个高频场景。用Python实现这个功能，其实比想象中要简单，核心在于理解SMTP协议，并巧妙运用Python的smtplib和email模块来构建和发送邮件。它能让我们摆脱重复的手动操作，无论是发送报告、通知还是提醒，都能高效完成。
Python代码操作SMTP服务的详细步骤
刚开始接触的时候，我总觉得这套流程会很复杂，涉及到各种网络协议的细节。但实践下来，Python的封装做得相当到位，我们更多是关注参数配置和邮件内容的组织。以下是一个基本的发送邮件流程：
- 导入必要的模块：
smtplib用于SMTP通信，email.mime.text（或email.mime.multipart、email.mime.base）用于构建邮件内容。 - 设置邮件信息：包括发件人邮箱、收件人邮箱、主题和邮件正文。
- 创建邮件对象：使用
MIMEText（纯文本邮件）或MIMEMultipart（包含附件、HTML等复杂邮件）。 - 连接SMTP服务器：通常使用
smtplib.SMTP_ssl（推荐，加密连接）或smtplib.SMTP（非加密，可配合starttls()升级为加密）。 - 登录SMTP服务器：使用发件人邮箱的账号和授权码（或密码）进行认证。
- 发送邮件：调用
sendmail()方法。 - 关闭连接：调用
quit()方法。
这是一个简单的纯文本邮件发送示例：
立即学习“Python免费学习笔记（深入）”；
import smtplib from email.mime.text import MIMEText from email.header import Header # 邮件配置 sender_email = 'your_email@example.com' # 替换为你的发件邮箱 receiver_email = 'recipient@example.com' # 替换为收件人邮箱 smtp_server = 'smtp.example.com' # 替换为你的SMTP服务器地址 (如：smtp.gmail.com) smtp_port = 465 # SSL端口通常是465，TLS/STARTTLS端口通常是587 smtp_username = 'your_email@example.com' # 替换为你的邮箱账号 smtp_password = 'your_app_password' # 替换为你的邮箱授权码或密码 # 邮件内容 subject = 'Python自动化邮件测试' body = '你好，这是一封通过Python自动化发送的测试邮件。' # 构建邮件 msg = MIMEText(body, 'plain', 'utf-8') msg['From'] = Header("发件人名称", 'utf-8') msg['To'] = Header("收件人名称", 'utf-8') msg['Subject'] = Header(subject, 'utf-8') try: # 连接到SMTP服务器 (使用SSL加密连接) server = smtplib.SMTP_SSL(smtp_server, smtp_port) # server.set_debuglevel(1) # 开启调试模式，可以看到详细的SMTP交互日志 # 登录邮箱 server.login(smtp_username, smtp_password) # 发送邮件 server.sendmail(sender_email, receiver_email, msg.as_string()) print("邮件发送成功！") except smtplib.SMTPException as e: print(f"邮件发送失败: {e}") except Exception as e: print(f"发生其他错误: {e}") finally: if 'server' in locals() and server: server.quit()
请注意，对于Gmail、outlook等主流邮箱服务，为了安全，通常需要生成一个“授权码”或“应用专用密码”来代替你的邮箱登录密码，否则可能会遇到认证失败的问题。
Python发送邮件时如何处理附件和HTML内容？
这块功能其实非常实用，毕竟纯文本邮件在很多场景下已经不够用了。尤其是附件，无论是报告、图片还是其他文件，都是邮件自动化不可或缺的一部分。处理附件和HTML内容，我们需要用到email.mime.multipart和email.mime.base模块。
MIMEMultipart对象可以看作是邮件的容器，我们可以往里面添加不同类型的子部分（比如文本、HTML、附件）。
发送HTML内容： 将MIMEText的第二个参数从'plain'改为'html'即可。
from email.mime.text import MIMEText html_body = """ <html> <head></head> <body> <p>你好，</p> <p>这是一封<b>HTML格式</b>的自动化测试邮件。</p> <p>这是一个链接：<a href="https://www.python.org">Python官网</a></p> </body> </html> """ msg_html = MIMEText(html_body, 'html', 'utf-8') # 然后像之前一样设置From, To, Subject，并通过SMTP发送
发送带附件的邮件： 这需要MIMEMultipart来组合邮件的不同部分，并使用MIMEBase（或更具体的MIMEApplication, MIMEImage等）来处理附件。
import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from email.mime.base import MIMEBase from email import encoders from email.header import Header import os sender_email = 'your_email@example.com' receiver_email = 'recipient@example.com' smtp_server = 'smtp.example.com' smtp_port = 465 smtp_username = 'your_email@example.com' smtp_password = 'your_app_password' subject = 'Python自动化邮件带附件' body = '请查收附件中的文件。' attachment_path = 'example.txt' # 假设有一个名为 example.txt 的文件在当前目录 # 创建MIMEMultipart对象 msg = MIMEMultipart() msg['From'] = Header("发件人名称", 'utf-8') msg['To'] = Header("收件人名称", 'utf-8') msg['Subject'] = Header(subject, 'utf-8') # 添加邮件正文 msg.attach(MIMEText(body, 'plain', 'utf-8')) # 添加附件 try: with open(attachment_path, 'rb') as f: part = MIMEBase('application', 'octet-stream') part.set_payload(f.read()) encoders.encode_base64(part) part.add_header('Content-Disposition', f'attachment; filename="{os.path.basename(attachment_path)}"') msg.attach(part) except FileNotFoundError: print(f"附件文件未找到: {attachment_path}") except Exception as e: print(f"处理附件时发生错误: {e}") # 接下来的SMTP连接和发送代码与之前相同 try: server = smtplib.SMTP_SSL(smtp_server, smtp_port) server.login(smtp_username, smtp_password) server.sendmail(sender_email, receiver_email, msg.as_string()) print("带附件邮件发送成功！") except smtplib.SMTPException as e: print(f"邮件发送失败: {e}") except Exception as e: print(f"发生其他错误: {e}") finally: if 'server' in locals() and server: server.quit()
这里，MIMEBase('application', 'octet-stream')表示这是一个通用的二进制文件附件。encoders.encode_base64(part)对附件内容进行Base64编码，这是邮件传输的常见做法。Content-Disposition头则指定了附件的文件名。
Python自动化邮件发送中常见的SMTP配置错误与安全考量有哪些？
我记得有一次，邮件死活发不出去，排查了半天，才发现是Gmail的安全设置里，“允许不够安全的应用”被关闭了。这种小细节，真是能让人抓狂。在自动化邮件发送过程中，配置错误和安全问题是开发者经常会遇到的挑战。
常见的SMTP配置错误：
- SMTP服务器地址或端口错误：不同的邮件服务商有不同的SMTP服务器地址（如
smtp.gmail.com，smtp.office365.com）和端口。SSL加密通常是465，STARTTLS通常是587。务必核对正确。 - 认证失败：
- 用户名或密码不正确：这是最常见的问题。对于Gmail、Outlook等，需要使用“授权码”或“应用专用密码”，而不是你的账户登录密码。
- 邮箱服务商的安全设置：某些邮箱会默认阻止来自“不够安全的应用”的登录尝试。需要手动在邮箱设置中开启此选项（如Gmail的“允许不够安全的应用访问”）。
- 两步验证：如果开启了两步验证，通常也需要生成应用专用密码。
- 网络或防火墙问题：你的服务器或本地网络可能阻止了对SMTP端口的访问。可以尝试
telnet smtp.example.com 465（或587）来测试端口连通性。 - 发件人邮箱未开启SMTP服务：某些企业邮箱或自定义域名邮箱可能需要管理员手动开启SMTP/POP3服务。
- 邮件发送频率限制：很多邮件服务商对个人账户的每日邮件发送量有上限，超出限制可能会被暂时封禁。
安全考量：
- 使用加密连接：始终优先使用SSL/TLS加密连接。
-
smtplib.SMTP_SSL(host, port)：直接建立SSL加密连接，通常端口是465。 -
smtplib.SMTP(host, port)配合server.starttls()：先建立非加密连接，再升级为TLS加密，通常端口是587。 - 避免在没有加密的情况下发送敏感信息（如登录凭据）。
-
- 避免硬编码凭据：将邮箱账号和授权码直接写在代码中是非常不安全的做法。
- 授权码或应用专用密码：如前所述，使用这种机制比直接使用主密码更安全，因为它通常可以独立撤销，且权限范围更小。
- 最小权限原则：确保用于发送邮件的账户只有发送邮件所需的权限，避免赋予不必要的权限。
- 日志记录：记录邮件发送的成功与失败，但不要在日志中记录敏感的凭据信息。
如何构建一个更健壮的Python邮件发送系统，包含错误处理和日志记录？
实际项目里，我们不可能指望邮件发送总是一帆风顺。网络波动、服务器临时故障，这些都可能导致发送失败。所以，一套完善的错误处理和日志机制，是衡量一个自动化系统是否健壮的关键。它能帮助我们快速定位问题，并在可能的情况下自动恢复。
错误处理（使用try-except）：
Python的smtplib模块定义了多种异常，我们可以针对性地捕获和处理。
-
smtplib.SMTPConnectError：无法连接到SMTP服务器。 -
smtplib.SMTPAuthenticationError：登录认证失败（用户名或密码错误）。 -
smtplib.SMTPServerDisconnected：服务器意外断开连接。 -
smtplib.SMTPRecipientsRefused：部分或所有收件人被服务器拒绝。 -
smtplib.SMTPDataError：服务器拒绝邮件数据。 -
smtplib.SMTPException：所有smtplib异常的基类。
在代码中，我们可以用try...except块来捕获这些异常，并根据异常类型采取不同的应对策略。
import smtplib # ... (其他导入和配置) def send_email_robust(sender, receiver, msg, smtp_server, smtp_port, username, password): try: server = smtplib.SMTP_SSL(smtp_server, smtp_port, timeout=10) # 设置连接超时 server.login(username, password) server.sendmail(sender, receiver, msg.as_string()) print(f"邮件成功发送至 {receiver}") return True except smtplib.SMTPConnectError as e: print(f"错误: 无法连接到SMTP服务器。请检查服务器地址、端口和网络连接。详细: {e}") except smtplib.SMTPAuthenticationError as e: print(f"错误: SMTP认证失败。请检查用户名和授权码/密码。详细: {e}") except smtplib.SMTPServerDisconnected as e: print(f"错误: SMTP服务器意外断开连接。详细: {e}") except smtplib.SMTPRecipientsRefused as e: print(f"错误: 收件人被服务器拒绝。详细: {e.recipients}") except smtplib.SMTPDataError as e: print(f"错误: 服务器拒绝邮件数据。可能是邮件内容或格式问题。详细: {e}") except smplib.SMTPException as e: print(f"发生通用SMTP错误: {e}") except Exception as e: print(f"发生未知错误: {e}") finally: if 'server' in locals() and server: server.quit() return False # 调用示例 # success = send_email_robust(sender_email, receiver_email, msg, smtp_server, smtp_port, smtp_username, smtp_password)
Python的logging模块功能强大且灵活，是记录应用程序事件的标准方式。它比简单的print()语句更适合生产环境。
import logging import smtplib # ... (其他导入和配置) # 配置日志 logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s', handlers=[ logging.FileHandler("email_automation.log"), # 记录到文件 logging.StreamHandler() # 也输出到控制台 ]) def send_email_with_logging(sender, receiver, msg, smtp_server, smtp_port, username, password): try: server = smtplib.SMTP_SSL(smtp_server, smtp_port, timeout=10) server.login(username, password) server.sendmail(sender, receiver, msg.as_string()) logging.info(f"邮件成功发送至 {receiver}，主题：{msg['Subject']}") return True except smtplib.SMTPConnectError as e: logging.error(f"无法连接到SMTP服务器。收件人: {receiver}。错误: {e}") except smtplib.SMTPAuthenticationError as e: logging.error(f"SMTP认证失败。收件人: {receiver}。错误: {e}") except smtplib.SMTPException as e: logging.error(f"发生SMTP错误。收件人: {receiver}。错误: {e}", exc_info=True) # exc_info=True 会记录完整的堆栈信息 except Exception as e: logging.critical(f"发生未知严重错误。收件人: {receiver}。错误: {e}", exc_info=True) finally: if 'server' in locals() and server: server.quit() return False # 调用示例 # success = send_email_with_logging(sender_email, receiver_email, msg, smtp_server, smtp_port, smtp_username, smtp_password)
通过logging模块，我们可以控制日志的级别（DEBUG, INFO, WARNING, ERROR, CRITICAL），将日志输出到文件、控制台，甚至通过网络发送。exc_info=True在记录错误时会包含完整的堆栈信息，这对于调试至关重要。
重试机制：
对于瞬时错误（如网络波动导致的连接失败），简单的重试机制可以显著提高系统的健壮性。
import time # ... (其他导入和配置，以及 send_email_with_logging 函数) MAX_RETRIES = 3 RETRY_DELAY_SECONDS = 5 def send_email_with_retries(sender, receiver, msg, smtp_server, smtp_port, username, password): for attempt in range(MAX_RETRIES): logging.info(f"尝试发送邮件至 {receiver} (尝试 {attempt + 1}/{MAX_RETRIES})") if send_email_with_logging(sender, receiver, msg, smtp_server, smtp_port, username, password): return True elif attempt < MAX_RETRIES - 1: logging.warning(f"邮件发送失败，将在 {RETRY_DELAY_SECONDS} 秒后重试...") time.sleep(RETRY_DELAY_SECONDS) logging.error(f"邮件发送至 {receiver} 失败，已达最大重试次数。") return False # 调用示例 # success = send_email_with_retries(sender_email, receiver_email, msg, smtp_server, smtp_port, smtp_username, smtp_password)
这个重试逻辑很简单，在失败后等待一段时间再尝试。实际应用中，重试策略可以更复杂，比如指数退避（每次重试的等待时间逐渐增加）。结合这些机制，我们的自动化邮件发送系统就能应对各种突发状况，变得更加可靠。