使用Python发送邮件：记录数据处理时间的自动化通知
使用Python发送邮件：记录数据处理时间的自动化通知
ytkz在日常的开发和运维工作中，我们经常需要程序在完成特定任务（例如数据处理、备份、定时脚本执行等）后，自动发送邮件通知相关人员。这不仅能让我们及时了解任务状态，还能在出现问题时迅速响应。本文将介绍如何使用 Python 的 smtplib 和 email 模块来实现邮件发送功能，并特别说明如何将其嵌入到应用中，例如在数据处理完成后发送通知。
为什么选择 Python 发送邮件？
- 自动化流程：当一个耗时的脚本（如数据分析、模型训练）执行完毕后，自动发送邮件通知可以省去人工检查的麻烦。
- 集成性好：Python 作为一门“胶水语言”，可以方便地集成到现有的应用或脚本中。
- 标准库支持：Python 内置了
smtplib和email模块，无需安装额外的第三方库即可实现核心功能。
准备工作
Python 环境：确保你的系统中已安装 Python。
开启邮箱的 SMTP 服务并获取授权码：
- 你需要在你的邮箱服务提供商（如 QQ 邮箱、163 邮箱、Gmail 等）的设置中开启 SMTP 服务。
- 重要：大多数邮箱服务商出于安全考虑，不再允许直接使用邮箱密码通过 SMTP 发送邮件，而是需要生成一个专用的“授权码”或“应用密码”。请务必查阅你邮箱服务商的帮助文档，了解如何获取这个授权码。本文示例中使用的
password参数就是指这个授权码，而非邮箱登录密码。
核心代码实现
我们将通过一个 EmailSender 类来封装邮件发送的逻辑。
import smtplib
from email.mime.text import MIMEText
from email.header import Header
class EmailSender:
def __init__(self, sender, password, smtp_server='smtp.163.com', smtp_port=465):
"""
初始化邮件发送器
:param sender: 发件人邮箱 (例如: 'your_username@163.com')
:param password: 邮箱授权码 (注意：不是邮箱登录密码！)
:param smtp_server: SMTP 服务器地址 (默认为163邮箱)
:param smtp_port: SMTP 端口 (默认465，使用SSL加密)
"""
self.sender = sender
self.password = password
self.smtp_server = smtp_server
self.smtp_port = smtp_port
def send_text_email(self, receiver, subject, content):
"""
发送纯文本邮件
:param receiver: 收件人邮箱 (例如: 'recipient@example.com')
:param subject: 邮件主题
:param content: 邮件正文内容
:return: 发送结果（True/False）和错误信息（如果有）
"""
try:
# 1. 创建邮件内容对象
# MIMEText有三个参数：第一个为文本内容，第二个 plain 设置文本格式，第三个 utf-8 设置编码
message = MIMEText(content, 'plain', 'utf-8')
# 2. 设置邮件头部信息
message['From'] = Header(self.sender, 'utf-8') # 发件人
message['To'] = Header(receiver, 'utf-8') # 收件人
message['Subject'] = Header(subject, 'utf-8') # 邮件主题
# 3. 建立SMTP连接（使用SSL加密）
# 使用 with 语句可以确保连接在使用完毕后自动关闭
with smtplib.SMTP_SSL(self.smtp_server, self.smtp_port) as server:
# 4. 登录SMTP服务器
server.login(self.sender, self.password)
# 5. 发送邮件
# sendmail方法有三个参数：发件人邮箱、收件人邮箱列表（可以是多个）、邮件内容的字符串表示
server.sendmail(self.sender, [receiver], message.as_string())
return True, "邮件发送成功！"
except smtplib.SMTPException as e: # 更具体的SMTP相关异常
return False, f"邮件发送失败 (SMTP错误): {str(e)}"
except Exception as e:
return False, f"邮件发送失败 (其他错误): {str(e)}"
# --- 使用示例 ---
if __name__ == '__main__':
# 步骤1: 配置发件人信息和SMTP服务器信息
# 请替换为你的发件人邮箱和获取到的授权码
SENDER_EMAIL = 'your_sender_email@163.com' # 例如: 'my_automation_bot@163.com'
AUTHORIZATION_CODE = 'YOUR_163_AUTHORIZATION_CODE' # 这是从163邮箱获取的授权码
# 如果使用其他邮箱服务商，请相应修改 smtp_server 和 smtp_port
# 例如 Gmail: smtp_server='smtp.gmail.com', smtp_port=465 (SSL) or 587 (TLS)
# 例如 QQ邮箱: smtp_server='smtp.qq.com', smtp_port=465 (SSL)
email_sender = EmailSender(
sender=SENDER_EMAIL,
password=AUTHORIZATION_CODE,
smtp_server='smtp.163.com', # 默认163邮箱，可根据你的邮箱服务商修改
smtp_port=465 # 默认SSL端口，可根据你的邮箱服务商修改
)
# 步骤2: 定义收件人、主题和内容
# 请替换为实际的收件人邮箱
RECEIVER_EMAIL = 'target_recipient@example.com' # 例如: 'admin@mycompany.com'
# 场景：数据处理任务完成通知
import time
start_time = time.time()
# 模拟一个耗时的数据处理任务
print("开始执行数据处理任务...")
time.sleep(5) # 模拟任务执行了5秒
end_time = time.time()
processing_time = end_time - start_time
print("数据处理任务完成！")
email_subject = '数据处理任务完成通知'
email_content = f"""
尊敬的用户：
您的数据处理任务已于 {time.strftime('%Y-%m-%d %H:%M:%S')} 完成。
本次任务共耗时: {processing_time:.2f} 秒。
祝您工作愉快！
自动化通知系统
"""
# 步骤3: 发送邮件
success, msg = email_sender.send_text_email(
receiver=RECEIVER_EMAIL,
subject=email_subject,
content=email_content
)
# 步骤4: 打印发送结果
if success:
print(f"成功发送邮件给 {RECEIVER_EMAIL}")
else:
print(f"发送邮件给 {RECEIVER_EMAIL} 失败: {msg}")
# 另一个示例：发送一个简单的文本邮件
success_simple, msg_simple = email_sender.send_text_email(
receiver=RECEIVER_EMAIL, # 可以是不同的收件人
subject='Python 邮件测试（纯文本）',
content='这是一封通过 Python 脚本发送的纯文本邮件测试。'
)
print(f"简单邮件发送结果: {msg_simple}")代码解析
__init__(self, sender, password, smtp_server, smtp_port):- 构造函数初始化发件人邮箱、授权码、SMTP 服务器地址和端口。
smtp_server和smtp_port提供了默认值，方便使用，同时也允许用户自定义以支持不同的邮件服务商。163 邮箱的 SSL 加密端口通常是 465。
send_text_email(self, receiver, subject, content):- 创建
MIMEText对象:MIMEText用于构建邮件内容。参数分别是邮件正文、MIME 子类型（'plain'表示纯文本，也可以是'html'发送 HTML 邮件）和字符编码（'utf-8'以支持中文）。 - 设置邮件头:
message['From'],message['To'],message['Subject']分别设置发件人、收件人和主题。Header对象用于处理邮件头中的非 ASCII 字符（如中文），确保其能正确显示。
- 建立 SMTP 连接:
smtplib.SMTP_SSL(self.smtp_server, self.smtp_port)创建一个 SSL 加密的 SMTP 连接。如果你的 SMTP 服务器使用 STARTTLS（通常在端口 587），则应使用smtplib.SMTP()然后调用server.starttls()。- 使用
with语句可以确保网络连接在操作完成后被正确关闭，即使发生错误。
- 登录服务器:
server.login(self.sender, self.password)使用发件人邮箱和授权码登录 SMTP 服务器。 - 发送邮件:
server.sendmail(self.sender, [receiver], message.as_string())执行发送。注意第二个参数receiver是一个列表，可以包含多个收件人邮箱。 - 异常处理:
try...except块捕获可能发生的错误（如认证失败、连接超时等），并返回相应的状态和信息。
- 创建
如何嵌入到你的应用中？
正如 if __name__ == '__main__': 中的示例所示，你可以轻松地将邮件发送功能集成到你的项目中：
- 实例化
EmailSender: 在你的应用或脚本开始时，或者在需要发送邮件的功能模块中，用你的邮箱配置初始化EmailSender对象。建议将邮箱和授权码等敏感信息存储在配置文件或环境变量中，而不是硬编码在代码里。 - 调用
send_text_email:- 在你的数据处理脚本的末尾，当所有操作成功完成后，获取处理开始和结束时间。
- 构造邮件的主题和内容，可以将处理耗时、任务状态、结果摘要等信息包含在内。
- 调用
email_sender.send_text_email()方法发送通知。
安全与最佳实践
- 切勿硬编码凭证：在生产环境中，避免将发件人邮箱和授权码直接写入代码。使用环境变量、配置文件（如
.env文件、JSON、YAML）或密钥管理服务来存储这些敏感信息。 - 错误处理：完善的错误处理机制非常重要。网络问题、认证失败、收件人地址错误等都可能导致发送失败。
- 异步发送：如果邮件发送是应用主流程的一部分，但不是关键阻塞步骤，可以考虑将其放入后台任务队列（如 Celery）中异步执行，避免影响主应用的响应时间。
- 频率限制：注意不要过于频繁地发送邮件，以免被邮件服务商视为垃圾邮件发送者而限制或封禁账户。
- 内容格式：除了纯文本，
email模块还支持发送 HTML 邮件、带附件的邮件等。如果需要更丰富的邮件内容，可以研究MIMEMultipart和MIMEApplication等类。
总结
通过 Python 的 smtplib 和 email 模块，我们可以方便地实现邮件发送功能，并将其集成到各种自动化任务中，如数据处理完成后的状态通知。这不仅提高了工作效率，也使得我们能更及时地掌握系统和任务的运行情况。记住，安全地管理你的邮箱凭证是首要任务！
希望这篇指南能帮助你顺利地在 Python 项目中加入邮件通知功能！
