引言
在自动化运维和日常办公中,电子邮件依然是最正式、最广泛使用的通知和交互手段。无论是定时发送报表、监控报警,还是自动处理用户请求,邮件自动化都是程序员工具箱中的必备技能。
在python领域,大多数开发者对smtplib发送邮件较为熟悉,但在邮件接收与处理(尤其是imap协议)方面却往往力不从心,通常需要编写大量底层代码来处理邮件解析、附件下载和搜索条件。本篇文章将深入浅出,不仅讲解如何使用smtplib发送带附件的复杂邮件,更将重点引入强大的第三方库——imap_tools,手把手教你如何优雅地读取和处理收件箱邮件,实现真正意义上的邮件自动化闭环。
夯实基础 —— 使用smtplib发送带附件的邮件
smtp(simple mail transfer protocol)是推送邮件的协议。python的smtplib模块封装了其底层细节,而email库则负责构建符合mime标准的邮件内容。
核心概念:mimemultipart
要发送带附件的邮件,我们不能使用简单的mimetext对象。因为邮件包含独立的两部分:正文和附件。这时需要用到mimemultipart,它是一个容器,可以将不同的mime部分组合在一起。
一个标准的带附件邮件结构如下:
mimemultipart(混合类型)
- mimetext(纯文本或html正文)
- mimebase / mimeapplication(附件)
实战:发送带excel附件的html邮件
下面的示例演示了如何连接qq邮箱的smtp服务器,发送一封包含html样式的正文,并附带一个excel文件的邮件。
import smtplib
from email.mime.multipart import mimemultipart
from email.mime.text import mimetext
from email.mime.base import mimebase
from email import encoders
from email.utils import formataddr
# 邮件配置
smtp_server = 'smtp.qq.com'
smtp_port = 587 # tls端口
sender_email = 'your_qq@qq.com'
sender_pwd = '你的授权码' # qq邮箱需使用授权码,非登录密码
def send_email_with_attachment(receiver, subject, html_content, attachment_path):
"""
发送带附件的html邮件
"""
# 创建一个混合类型的邮件对象
msg = mimemultipart()
msg['from'] = formataddr(('自动化发送者', sender_email))
msg['to'] = receiver
msg['subject'] = subject
# 1. 添加html正文
msg.attach(mimetext(html_content, 'html', 'utf-8'))
# 2. 处理附件
try:
with open(attachment_path, 'rb') as f:
# 创建附件对象 (mimebase)
part = mimebase('application', 'octet-stream')
part.set_payload(f.read())
# 编码为base64
encoders.encode_base64(part)
# 添加头部信息,声明此为附件
filename = attachment_path.split('/')[-1] # 获取文件名
part.add_header(
'content-disposition',
f'attachment; filename="{filename}"'
)
msg.attach(part)
except filenotfounderror:
print(f"附件 {attachment_path} 未找到,邮件将无附件发送。")
# 3. 发送邮件
try:
server = smtplib.smtp(smtp_server, smtp_port)
server.starttls() # 启用tls加密
server.login(sender_email, sender_pwd)
server.sendmail(sender_email, receiver, msg.as_string())
server.quit()
print(f"邮件发送成功至 {receiver}")
except exception as e:
print(f"发送失败: {e}")
# 使用示例
if __name__ == '__main__':
html_body = """
<h2>月度数据报告</h2>
<p>您好,</p>
<p>本月销售数据请见附件。</p>
<p><strong>请注意:</strong> 此邮件由系统自动发送,请勿回复。</p>
"""
send_email_with_attachment(
receiver='target@example.com',
subject='【自动化】2024年5月销售报表',
html_content=html_body,
attachment_path='./report.xlsx' # 假设当前目录有该文件
)
注意事项:
- 使用
.starttls()时端口通常为587;若使用ssl,则端口为465并改用smtplib.smtp_ssl。 - 对于gmail、qq等邮箱,务必使用授权码而非邮箱密码,以确保安全性。
进阶突破 —— 使用imap_tools智能处理收件箱
发送邮件只是自动化的一半。如何自动读取邮件、下载附件或根据规则自动回复,才是真正的难点。标准库imaplib虽然功能强大,但使用起来较为繁琐。这里推荐使用基于imaplib封装的高阶库——imap_tools,它提供了简洁的查询语法和对象化的邮件属性。
安装与基础连接
首先,安装这个轻量级且无外部依赖的库:
pip install imap-tools
基础连接使用上下文管理器(with语句),确保连接自动关闭:
from imap_tools import mailbox
# 连接imap服务器(qq邮箱imap地址:imap.qq.com)
with mailbox('imap.qq.com').login('your_qq@qq.com', '你的授权码', initial_folder='inbox') as mailbox:
print("登录成功,当前文件夹:收件箱")
# 后续操作...
强大的查询语法(and/or/not)
imap_tools的核心优势在于其查询构造器。它模仿了sqlalchemy的语法,告别了复杂的imap搜索字符串。
基本查询示例:
from imap_tools import mailbox, and, or, not
with mailbox('imap.qq.com').login('your_qq@qq.com', '授权码', 'inbox') as mailbox:
# 1. 查询未读邮件
unread_emails = mailbox.fetch(and(seen=false))
# 2. 查询特定发件人且包含附件的邮件
specific_emails = mailbox.fetch(and(from_='boss@company.com', subject='报告'))
# 3. 复杂查询:来自某个域,或者是紧急邮件
complex_query = or(
from_='@important.com',
subject='urgent'
)
for msg in mailbox.fetch(complex_query):
print(msg.subject)
# 4. 日期范围查询:近3天的邮件
from datetime import date, timedelta
three_days_ago = date.today() - timedelta(days=3)
recent_mails = mailbox.fetch(and(date_gte=three_days_ago))
解析邮件并下载附件
mailmessage对象提供了直观的属性来访问邮件内容。以下是一个自动下载所有未读邮件附件的脚本:
import os
from imap_tools import mailbox, and
download_dir = './attachments'
def download_attachments_from_inbox():
# 确保下载目录存在
os.makedirs(download_dir, exist_ok=true)
with mailbox('imap.qq.com').login('your_qq@qq.com', '授权码', 'inbox') as mailbox:
# 获取所有未读邮件
# fetch 返回一个生成器,支持分页和排序,这里设置 reverse=true 让最新的邮件先出现
for msg in mailbox.fetch(and(seen=false), reverse=true, limit=50): # 限制处理50封,防止过载
print(f"处理邮件: {msg.subject} 来自: {msg.from_}")
# 检查是否有附件
if msg.attachments:
for att in msg.attachments:
# att 是 mailattachment 对象
filename = att.filename
# 可以按文件类型过滤
if filename.endswith(('.xlsx', '.pdf', '.docx')):
file_path = os.path.join(download_dir, filename)
# att.payload 是附件的二进制数据 (bytes)
with open(file_path, 'wb') as f:
f.write(att.payload)
print(f" 已下载附件: {filename}")
# 处理完后,可以将邮件标记为已读(默认fetch时mark_seen=true),或移动到其他文件夹
# 将邮件移动到 "processed" 文件夹
mailbox.move([msg.uid], 'processed')
else:
# 无附件邮件,直接标记为已读,也可以不做任何操作
# 如果不希望在fetch时自动标记已读,可以在fetch参数中设置 mark_seen=false
pass
if __name__ == '__main__':
download_attachments_from_inbox()
代码解析:
msg.attachments返回一个由mailattachment对象组成的列表,每个对象包含filename、payload(二进制)、content_type等属性。mailbox.move([msg.uid], 'processed')演示了如何将处理完的邮件移动到指定文件夹,实现收件箱归零。fetch方法的limit参数可以有效防止一次性处理大量邮件导致的性能问题。
邮件自动回复机器人雏形
结合发送和接收,我们可以构建一个简单的自动应答机器人:当收到特定主题的邮件时,自动回复预设内容。
import smtplib
from email.mime.text import mimetext
from imap_tools import mailbox, and
# 发送函数 (简化版)
def send_reply(to_addr, original_subject):
smtp_server = smtplib.smtp('smtp.qq.com', 587)
smtp_server.starttls()
smtp_server.login('your_qq@qq.com', '授权码')
msg = mimetext('感谢您的来信,我们已经收到您的请求,会尽快处理。', 'plain', 'utf-8')
msg['from'] = 'your_qq@qq.com'
msg['to'] = to_addr
msg['subject'] = f're: {original_subject} [自动回复]'
smtp_server.send_message(msg)
smtp_server.quit()
# 主监控逻辑
def auto_responder():
with mailbox('imap.qq.com').login('your_qq@qq.com', '授权码', 'inbox') as inbox:
# 查找未读的、主题包含"咨询"的邮件
for msg in inbox.fetch(and(seen=false, subject='咨询')):
# 发送自动回复
send_reply(msg.from_, msg.subject)
print(f"已回复: {msg.from_}")
# 标记为已读并添加自定义标志
inbox.flag([msg.uid], ['answered'], true)
综合实战:监控邮箱并自动备份附件
假设你有一个需求:每天定时检查收件箱,将当天收到的所有邮件的excel附件下载下来,并将下载记录发送给管理员。
完整流程:
- 使用
imap_tools连接imap,查询当天日期范围内的邮件。 - 遍历邮件,下载
.xlsx附件。 - 所有附件下载完成后,调用
smtplib发送一封汇总邮件给管理员。
这部分代码融合了上述所有知识点,是邮件自动化的典型应用场景。通过结合操作系统的定时任务(如linux crontab或windows任务计划程序),即可实现无人值守的自动化处理。
常见问题与避坑指南
授权码 vs 密码:几乎所有主流邮箱(qq、163、gmail)在开启smtp/imap服务后,都需要使用生成的授权码作为密码登录,直接使用网页登录密码会报错。
imap文件夹名称:默认收件箱是inbox。其他文件夹(如“已发送”、“归档”)的名称可能因邮箱服务商而异,例如qq邮箱的“已发送”可能是&xfjt0zab4这种编码形式。建议先使用mailbox.folder.list()打印所有文件夹名称。
附件编码:att.payload返回的是原始二进制数据,直接写入文件即可。如果遇到附件名乱码,可以使用att.filename,该属性通常已经被imap-tools处理过。
性能考量:如果需要处理海量邮件,务必使用fetch的limit和bulk参数。设置bulk=true可以减少与服务器的交互次数,但会占用更多内存。
到此这篇关于python邮件自动化实战之发送附件和智能处理收件箱的文章就介绍到这了,更多相关python邮件自动化内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论