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格式的自动化测试邮件。
这是一个链接：Python官网
"""
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。 - 避免在没有加密的情况下发送敏感信息（如登录凭据）。
-
-
避免硬编码凭据：将邮箱账号和授权码直接写在代码中是非常不安全的做法。
- 环境变量：推荐将敏感信息存储在环境变量中，代码运行时读取。
-
配置文件：使用
.ini、.json或.env等配置文件，但要确保这些文件不会被意外提交到版本控制系统（如Git）。 - 密钥管理服务：在生产环境中，可以考虑使用云服务商提供的密钥管理服务。
- 授权码或应用专用密码：如前所述，使用这种机制比直接使用主密码更安全，因为它通常可以独立撤销，且权限范围更小。
- 最小权限原则：确保用于发送邮件的账户只有发送邮件所需的权限，避免赋予不必要的权限。
- 日志记录：记录邮件发送的成功与失败，但不要在日志中记录敏感的凭据信息。
如何构建一个更健壮的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)日志记录（使用logging模块）：
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)这个重试逻辑很简单，在失败后等待一段时间再尝试。实际应用中，重试策略可以更复杂，比如指数退避（每次重试的等待时间逐渐增加）。结合这些机制，我们的自动化邮件发送系统就能应对各种突发状况，变得更加可靠。
