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消息的逻辑这样无论遇到什么需求你都能快速找到解决方案。
