你是否需要一个关于发送邮件的Python案例

访客 python案例 2026-06-04 23:46:48 3

本文目录导读：

目录导读
Python发送邮件的应用场景
核心模块：smtplib与email的使用概览
实战案例：从零搭建一个带附件的邮件发送脚本
常见问题与问答（FAQ）
代码优化与安全性建议
总结：何时需要这个案例？

你是否需要一个关于发送邮件的Python案例？完整实战指南与避坑解析

目录导读

引言：Python发送邮件的应用场景
核心模块：smtplib与email的使用概览
实战案例：从零搭建一个带附件的邮件发送脚本
常见问题与问答（FAQ）
代码优化与安全性建议
何时需要这个案例？

Python发送邮件的应用场景

在日常开发与运维中,自动发送邮件是一个高频需求。

监控报警系统自动通知运维人员
网站注册后发送验证邮件
定期汇总报告发送给管理层
自动化测试结果通知

很多新手或初级开发者会问：“我该不该花时间学习Python发邮件？” 答案是——绝对是，除非你只想手动点鼠标发100封邮件，Python的smtplib和email库让你用不到30行代码就能解决批量发送问题，且支持HTML、附件、加密等高级功能。

核心模块：smtplib与email的使用概览

Python标准库中自带两个关键模块：

smtplib：负责建立与SMTP服务器的连接和通信。
email.mime：用于构建邮件内容（纯文本、HTML、附件等）。

常见SMTP服务器配置参考

邮箱类型	SMTP服务器	端口（SSL/TLS）
Gmail	smtp.gmail.com	587 (TLS) / 465 (SSL)
QQ邮箱	smtp.qq.com	587 (TLS) / 465 (SSL)
网易163	smtp.163.com	25 (非加密) / 465 (SSL)
Outlook	smtp-mail.outlook.com	587 (TLS)

注意：大部分邮箱需要开启“SMTP服务”并获取授权码（非登录密码），例如QQ邮箱需要在设置-账户中开启，并生成专属授权码。

实战案例：从零搭建一个带附件的邮件发送脚本

以下是一个完整的Python案例,支持发送HTML内容+一个PDF附件：

import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email import encoders
# 邮件配置
sender = "your_email@qq.com"
password = "你的授权码"  # 非QQ密码
receiver = "target@example.com"
smtp_server = "smtp.qq.com"
port = 587  # TLS端口
# 构建邮件对象
msg = MIMEMultipart()
msg["From"] = sender
msg["To"] = receiver
msg["Subject"] = "测试邮件：来自Python自动发送"
HTML格式）
body = """
<h2>你好，</h2>
<p>这是一封来自Python脚本的测试邮件。</p>
<p>请查收附件中的报告文件。</p>
"""
msg.attach(MIMEText(body, "html", "utf-8"))
# 添加附件（假设有一个report.pdf）
filename = "report.pdf"
attachment = open(filename, "rb")
part = MIMEBase("application", "octet-stream")
part.set_payload(attachment.read())
encoders.encode_base64(part)
part.add_header(
    "Content-Disposition",
    f"attachment; filename= {filename}",
)
msg.attach(part)
attachment.close()
# 发送邮件
try:
    server = smtplib.SMTP(smtp_server, port)
    server.starttls()  # 启用TLS加密
    server.login(sender, password)
    text = msg.as_string()
    server.sendmail(sender, receiver, text)
    print("✅ 邮件发送成功！")
except Exception as e:
    print(f"❌ 发送失败：{e}")
finally:
    server.quit()

关键点解析

starttls() 确保传输过程加密，避免密码泄露。
使用 MIMEMultipart 可以同时承载正文和附件。
附件使用 MIMEBase 并编码为base64，确保兼容性。

常见问题与问答（FAQ）

Q1：登录失败，报错“Authentication required”怎么办？

A：多数情况下是密码错误，请确认使用的是授权码而非邮箱登录密码，QQ邮箱、Gmail都需要单独生成授权码，另外检查SMTP服务器地址和端口是否正确。

Q2：发送成功后对方收不到邮件？

A：可能原因：

邮件被归入垃圾邮件箱（检查标题和内容是否过于简单）。
QQ邮箱等对短时间大量发送有限流。
发件人邮箱未验证（如某些企业邮箱需要加白名单）。

Q3：能否同时发送给多人？

A：可以，将receiver改为列表，msg["To"]用逗号拼接字符串，sendmail时传入列表：

receivers = ["a@example.com", "b@example.com"]
msg["To"] = ", ".join(receivers)
server.sendmail(sender, receivers, text)

Q4：如何发送纯文本邮件而不是HTML？

A：将MIMEText(body, "html", "utf-8")改为MIMEText(body, "plain", "utf-8")即可。

Q5：脚本部署到服务器后无法发送？

A：检查服务器是否屏蔽了25端口，部分云服务商（如阿里云）默认封禁25端口，需改用587（TLS）或465（SSL），也可使用高信誉的第三方邮件服务如SendGrid、Mailgun等。

代码优化与安全性建议

勿硬编码密码：使用环境变量或 .env 文件存储敏感信息。
```
import os
password = os.getenv("EMAIL_PASSWORD")
```
添加重试机制：网络波动可能导致发送失败，建议加入简单的重试逻辑（如失败后等5秒重试3次）。
日志记录：记录发送时间、收件人、是否成功，便于排查问题。
处理大附件：超过25MB的附件可能被邮箱服务器拒绝，建议先压缩或使用云存储链接。
防止“封号”：不要用个人邮箱频繁发送营销邮件，应使用专业邮件服务。