Python如何发送电子邮件？smtplib模块完整流程

邮件发送失败常见原因包括：未使用邮箱授权码而直接使用登录密码；smtp服务器地址或端口配置错误（如qq邮箱应使用smtp.qq.com:465用于ssl）；网络或防火墙限制导致无法连接；邮件内容被识别为垃圾邮件；邮箱地址拼写错误。2. 发送带附件或html内容的邮件需使用email模块的mime组件：html内容通过mimetext(content, ‘html’, ‘utf-8’)实现；附件需读取为二进制数据，用mimebase封装并base64编码，再通过content-disposition头设置为附件。3. 大批量发送邮件时应避免使用个人邮箱smtp服务，因其有频率和数量限制，易被封禁；建议采用专业邮件服务如sendgrid、阿里云邮件推送等以提高送达率；若自行发送，需控制频率、添加异常重试机制、记录日志并安全存储授权码（如使用环境变量）。使用python发送电子邮件的核心是smtplib与email模块协同工作，遵循此流程可实现稳定高效的邮件发送功能。

使用Python发送电子邮件，核心在于利用其内置的

smtplib

模块来与邮件服务器进行通信，以及

email

模块来构建符合MIME标准的邮件内容。简单来说，就是通过代码模拟一个邮件客户端的行为：连接到服务器、登录、然后把准备好的邮件内容“投递”出去。这听起来有点像在邮局寄信，

smtplib

是邮递员，

email

模块则帮你把信封、信纸、照片（附件）都整理得妥妥当当。

解决方案

要用Python发送电子邮件，我们通常会经历以下几个步骤，这基本上是一个标准流程：

1. 导入必要的模块：

   smtplib

   负责连接和发送，

   email.mime.text.MIMEText

   用于纯文本或HTML内容，

   email.mime.multipart.MIMEMultipart

   用于组合多部分邮件（如文本+附件），而

   email.mime.base.MIMEBase

   和

   email.encoders

   则用于处理附件。

2. 配置邮件信息：包括发件人邮箱、收件人邮箱、邮件主题、邮件正文，以及SMTP服务器地址和端口。特别要注意的是，很多主流邮箱服务（如QQ邮箱、163邮箱、Gmail等）出于安全考虑，不再允许你直接使用登录密码进行SMTP认证，而是需要生成一个“授权码”或“应用专用密码”。这往往是新手最容易踩的坑。
3. 构建邮件内容：使用

   MIMEMultipart

   对象作为邮件的“容器”，然后将文本、HTML内容（如果需要）或附件作为子部分添加到这个容器中。

4. 建立SMTP连接：根据邮件服务器的要求，选择

   smtplib.SMTP_SSL

   （推荐，端口通常是465）进行SSL加密连接，或者

   smtplib.SMTP

   配合

   starttls()

   （端口通常是587）进行TLS加密。

5. 登录邮件服务器：使用发件人邮箱和前面提到的授权码进行身份验证。
6. 发送邮件：调用

   send_message()

   或

   sendmail()

   方法发送邮件。

7. 关闭连接：发送完成后，记得调用

   quit()

   方法断开与服务器的连接，释放资源。

这是一个简单的代码示例，展示了如何发送一封纯文本邮件：

立即学习“Python免费学习笔记（深入）”；

import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from email.header import Header  # --- 邮件配置信息 --- sender_email = 'your_email@example.com'  # 发件人邮箱 sender_password = 'your_app_password'    # 发件人邮箱的授权码或应用专用密码 receiver_email = 'recipient@example.com' # 收件人邮箱 smtp_server = 'smtp.example.com'         # SMTP服务器地址 (例如：smtp.qq.com, smtp.163.com, smtp.gmail.com) smtp_port = 465                          # SMTP服务器端口 (SSL通常是465，TLS通常是587)  # --- 构建邮件内容 --- msg = MIMEMultipart() msg['From'] = Header("发件人昵称", 'utf-8') msg['To'] = Header("收件人昵称", 'utf-8') msg['Subject'] = Header("Python邮件测试", 'utf-8')  # 邮件正文 mail_content = """ 你好！  这是一封通过Python smtplib模块发送的测试邮件。 希望你能收到！  此致 敬礼 你的Python脚本 """ msg.attach(MIMEText(mail_content, 'plain', 'utf-8'))  try:     # --- 建立SMTP连接并发送邮件 ---     # 对于SSL连接，使用SMTP_SSL     server = smtplib.SMTP_SSL(smtp_server, smtp_port)     # 如果是SMTP并需要starttls，则：     # server = smtplib.SMTP(smtp_server, smtp_port)     # server.ehlo()     # server.starttls()     # server.ehlo()      server.login(sender_email, sender_password)     server.send_message(msg) # 或者 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()

为什么我的邮件总是发送失败？常见问题与排查

我刚开始接触Python邮件发送时，最头疼的就是邮件总是发不出去，报错信息也看得云里雾里。后来才发现，这其中有不少“坑”，但大部分都有迹可循。

一个最常见的问题就是授权码（或应用专用密码）的使用。很多邮箱服务，比如QQ邮箱、163邮箱、Gmail，为了账户安全，不允许第三方应用直接使用你的登录密码进行SMTP认证。你需要登录邮箱的网页版设置，找到“POP3/IMAP/SMTP服务”或者“客户端授权码”相关的选项，生成一个专门用于第三方客户端的授权码。这个授权码就是你在Python脚本里

server.login()

时要用的“密码”，而不是你平时登录邮箱的密码。这真是个让人头疼但又不得不面对的现实。

其次，SMTP服务器地址和端口配置错误也是常犯的错误。不同的邮箱服务商有不同的SMTP服务器地址（比如QQ邮箱是

smtp.qq.com

，163邮箱是

smtp.163.com

，Gmail是

smtp.gmail.com

）。端口也分两种主流：SSL加密通常用465，TLS加密通常用587。如果你选错了端口或者加密方式，连接自然会失败。有时候，你的网络环境或者防火墙也可能阻碍你连接到这些端口。

还有，发件人邮箱或收件人邮箱地址拼写错误，或者邮件内容被邮件服务商判定为垃圾邮件。后者尤其需要注意，如果你的邮件主题或内容过于简单、包含敏感词汇、或者发送频率过高，很可能直接被服务器拒绝或者被收件箱直接扔进垃圾箱。排查这类问题，可以先尝试发送一封最简单的纯文本邮件给自己，如果成功了，再逐步增加复杂性。

如何发送带附件、HTML内容的邮件？MIME的妙用

发送带附件或者HTML内容的邮件，就得请出

email

模块的MIME（Multipurpose Internet Mail Extensions）家族了。MIME这东西，听起来很技术，但其实就是个“打包盒”，它规定了邮件内容的各种类型和编码方式，让邮件客户端能够正确地解析和显示邮件。

要发送HTML内容的邮件，你只需要把

MIMEText

的第二个参数从

'plain'

改成

'html'

就行了。比如：

MIMEText(html_content, 'html', 'utf-8')

。

而附件的处理则稍微复杂一些，但原理都是把附件文件读取成二进制数据，然后进行Base64编码，再封装成一个

MIMEBase

对象，最后添加到

MIMEMultipart

这个“主容器”里。你需要指定附件的文件名、MIME类型（比如图片是

image/jpeg

，PDF是

application/pdf

），以及一个

Content-Disposition

头，告诉邮件客户端这是一个附件。

import os from email.mime.base import MIMEBase from email import encoders  # ... (前面的邮件配置和MIMEMultipart初始化代码不变) ...  # 添加HTML内容 html_content = """ <html> <body>     <p>你好！</p>     <p>这是一封<b>HTML格式</b>的邮件，来自Python脚本。</p>     <p>希望你喜欢！</p>     @@##@@ </body> </html> """ msg.attach(MIMEText(html_content, 'html', 'utf-8'))  # 添加附件 (以一个图片文件为例) # 假设当前目录下有一个 'example.png' 文件 file_path = 'example.png' if os.path.exists(file_path):     part = MIMEBase('application', 'octet-stream') # 通用二进制类型     with open(file_path, 'rb') as file:         part.set_payload(file.read())     encoders.encode_base64(part) # 进行Base64编码      # 设置附件的文件名，确保中文文件名显示正常     encoded_filename = Header(os.path.basename(file_path), 'utf-8').encode()     part.add_header('Content-Disposition', 'attachment', filename=encoded_filename)     msg.attach(part) else:     print(f"警告：附件文件 '{file_path}' 不存在，将不发送附件。")  # 如果HTML中包含内联图片（cid:image1.png），需要单独添加 # from email.mime.image import MIMEImage # with open('image1.png', 'rb') as img_file: #     msg_image = MIMEImage(img_file.read()) #     msg_image.add_header('Content-ID', '<image1.png>') # 这里的ID要和HTML中的src="cid:..."对应 #     msg.attach(msg_image)  # ... (后面的SMTP连接和发送代码不变) ...

通过

MIMEMultipart

，你可以把文本、HTML、各种附件像搭积木一样组合起来，非常灵活。

大批量发送邮件需要注意什么？安全与效率考量

如果你需要通过Python发送大量的邮件，比如产品通知、营销邮件或者系统警报，那么使用个人邮箱的SMTP服务直接发送，很快就会遇到瓶颈，甚至可能导致你的邮箱被服务商暂时封禁。我之前有个项目需要发大量通知，一开始想着用自己的邮箱硬扛，结果没发几封就被封了。后来才意识到，专业的事还得专业工具来办。

首先，个人邮箱的SMTP服务通常有严格的发送频率和数量限制。你不可能指望通过一个个人邮箱一天发送几万封邮件。一旦触发了这些限制，你的邮件可能会被退回，甚至你的账户可能会被标记为垃圾邮件发送者。

其次，邮件送达率是个大问题。自己发送的邮件，很可能被收件方的垃圾邮件过滤器拦截，最终根本到不了用户的收件箱。专业的邮件服务提供商（ESP，Email Service Provider），比如SendGrid、Mailgun、或者国内的腾讯邮件推送、阿里云邮件推送等，它们有专门的IP信誉管理、反垃圾邮件机制和投递优化技术，能大大提高邮件的送达率。虽然它们通常是付费服务，但对于商业或大规模应用来说，这是非常值得的投资。

如果你确实需要自己处理，并且量不大，那么有几个点可以考虑：

• 控制发送频率：在发送每封邮件之间加入适当的

  time.sleep()

  ，避免短时间内发送大量邮件。

• 异常处理和重试机制：网络波动、服务器临时故障都可能导致发送失败。为你的发送逻辑加上健壮的

  try-except

  块，并在失败时考虑重试几次。

• 日志记录：记录每封邮件的发送状态，包括成功、失败原因等，方便后续排查问题。
• 安全存储凭证：不要将你的邮箱授权码直接写死在代码里，尤其是在公共代码库中。考虑使用环境变量、配置文件或更安全的密钥管理服务来存储这些敏感信息。

总之，对于小规模的通知或个人使用，

smtplib

已经足够强大。但一旦涉及到“大批量”这个词，就得认真考虑专业的邮件服务了，它们不仅能解决发送效率和送达率的问题，还能提供详细的发送报告和统计分析，这些都是自己搭建无法比拟的优势。