python必背源代码发邮件smtplib代码
全面讲解Python使用内置标准库smtplib与email发送邮件的必背核心源代码。包含纯文本邮件、HTML格式邮件及附件发送实战,详解授权码配置、465与587端口加密协议选型及云服务器常见报错排查。
在 Python 自动化运维、定时巡检、报表推送以及业务系统告警中,使用代码发送邮件是一项高频且基础的操作。Python 标准库自带了 smtplib 与 email 两个模块,无需执行任何 pip install 即可直接完成纯文本、富文本 HTML 以及多格式附件的发送。实现邮件发送的核心逻辑非常明确:使用 email.mime 组装符合网络协议规范的报文结构,再通过 smtplib 建立加密通道并投递到目标邮箱服务器。本文提供可以直接复用、符合生产级规范的必背源码,并拆解授权码机制、端口协议差异与云服务器部署避坑要点。
一、发信前的准备工作:获取客户端“授权码”
许多初学者直接把个人邮箱的网页端登录密码填入代码中,结果必定会遭遇 535 Error: authentication failed。国内主流公网邮箱(如 QQ 邮箱、网易 163 邮箱)为了保障主密码安全,强制要求第三方自动化程序使用独立生成的客户端授权码(即专用应用密码)。
获取步骤与关键操作:
- QQ 邮箱:登录网页端,依次点击【设置】→【账户】→ 下拉找到【POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务】,开启“POP3/SMTP服务”,根据提示发送短信即可获得一串 16 位的英文授权码。
- 网易 163 邮箱:登录网页端,点击【设置】→【POP3/SMTP/IMAP】,勾选开启“POP3/SMTP服务”,随后点击【新增授权密码】并妥善保存。
- 企业邮箱与 Gmail:腾讯企业邮/网易企业邮需在安全设置中生成专用客户端密码;Gmail 则需在 Google 账户中开启两步验证后生成“应用专用密码”。
| 邮箱服务商 | SMTP 服务器地址 | 推荐 SSL 端口 | 替代 STARTTLS 端口 |
|---|---|---|---|
| QQ 邮箱 | smtp.qq.com |
465 |
587 |
| 网易 163 邮箱 | smtp.163.com |
465 |
25 (限非云主机) |
| 腾讯企业邮 | smtp.exmail.qq.com |
465 |
587 |
| 微软 Outlook | smtp.office365.com |
- |
587 |
| 谷歌 Gmail | smtp.gmail.com |
465 |
587 |
二、标准库分工:MIME 报文构建与 SMTP 传输链路
在编写代码前,必须理清 Python 发邮件涉及的两个模块:
email模块:负责“封包”。负责将文本、HTML、附件及标头(发件人、收件人、主题)按互联网 RFC 5322 与 MIME 标准封装为一段格式合规的纯文本字符串。smtplib模块:负责“邮差”。负责与远端邮件服务器(如smtp.qq.com)建立 TCP 连接、协商加密握手、执行身份认证(AUTH LOGIN),并将封装好的报文推送到目标服务器。
三、必背核心代码一:发送纯文本邮件(SSL 465 端口)
这是日常自动化脚本中最常用、结构最精炼的代码模版。采用 smtplib.SMTP_SSL 直接在 465 端口建立全链路加密连接,同时配合 with 上下文管理器确保无论成功或报错均能安全释放网络连接。
import smtplib
from email.mime.text import MIMEText
from email.header import Header
def send_plain_email():
# 1. 基础配置参数
smtp_host = "smtp.qq.com" # SMTP 服务器地址
smtp_port = 465 # SSL 端口
sender = "your_email@qq.com" # 发件人邮箱账号
auth_code = "abcdefghijklmnop" # 邮箱网页端生成的 16 位授权码
receivers = ["receiver@example.com"] # 收件人列表
# 2. 组装邮件内容 (纯文本格式)
content = "这是一封来自 Python 自动化脚本的测试邮件。\n系统巡检正常完成。"
msg = MIMEText(content, _subtype='plain', _charset='utf-8')
# 3. 设置邮件标头 (必须使用 Header 防止中文乱码与退信)
msg['Subject'] = Header("【系统监控】服务器日常巡检报告", 'utf-8')
msg['From'] = Header(f"监控中心 <{sender}>", 'utf-8')
msg['To'] = Header(";".join(receivers), 'utf-8')
# 4. 建立 SSL 加密连接并投递
try:
with smtplib.SMTP_SSL(smtp_host, smtp_port, timeout=10) as server:
server.login(sender, auth_code)
server.sendmail(sender, receivers, msg.as_string())
print("邮件投递成功!")
except smtplib.SMTPException as e:
print(f"邮件发送失败,异常原因: {e}")
if __name__ == "__main__":
send_plain_email()
1.
msg['To'] 与 sendmail(..., receivers, ...) 的区别:msg['To'] 仅用于邮件客户端界面展示,属于信件内部的抬头;而 sendmail 的第二个参数 receivers 才是 SMTP 服务器用于真正路由投递的收件邮箱列表(必须为 Python 列表类型)。
2.
msg.as_string():把 MIMEText 对象序列化为符合网络传输规范的原始文本流。
四、邮件发送标准四步执行流程
无论是简单的告警短信还是复杂的带附件报表,所有基于 smtplib 的程序都严格遵循这四个标准阶段:
五、必背核心代码二:发送富文本 HTML 格式邮件
当需要向团队推送带有排版表格、报警状态高亮颜色、甚至超链接按钮的邮件时,纯文本无法胜任。只需将 MIMEText 的 _subtype 参数由 'plain' 切换为 'html',即可直接嵌入标准 HTML 代码。
import smtplib
from email.mime.text import MIMEText
from email.header import Header
def send_html_email():
smtp_host = "smtp.qq.com"
smtp_port = 465
sender = "your_email@qq.com"
auth_code = "abcdefghijklmnop"
receivers = ["receiver@example.com"]
# 编写 HTML 模板正文 (支持内联 CSS 样式)
html_content = """
<div style="font-family: Arial, 'Microsoft YaHei', sans-serif; padding: 20px; border: 1px solid #DCE3EB; border-radius: 8px;">
<h3 style="color: #456581; margin-bottom: 12px;">API 服务每日健康检查汇总</h3>
<p style="color: #475569;">尊敬的管理员,以下为最新监控节点状态:</p>
<table style="width: 100%; border-collapse: collapse; margin: 16px 0;">
<tr style="background-color: #F1F5F9;">
<th style="padding: 8px; border: 1px solid #CBD5E1; text-align: left;">服务名称</th>
<th style="padding: 8px; border: 1px solid #CBD5E1; text-align: center;">状态</th>
<th style="padding: 8px; border: 1px solid #CBD5E1; text-align: right;">平均延迟</th>
</tr>
<tr>
<td style="padding: 8px; border: 1px solid #CBD5E1;">用户鉴权服务 (Auth)</td>
<td style="padding: 8px; border: 1px solid #CBD5E1; text-align: center; color: #166534; font-weight: bold;">正常 (200 OK)</td>
<td style="padding: 8px; border: 1px solid #CBD5E1; text-align: right;">18 ms</td>
</tr>
<tr>
<td style="padding: 8px; border: 1px solid #CBD5E1;">支付网关服务 (Payment)</td>
<td style="padding: 8px; border: 1px solid #CBD5E1; text-align: center; color: #166534; font-weight: bold;">正常 (200 OK)</td>
<td style="padding: 8px; border: 1px solid #CBD5E1; text-align: right;">32 ms</td>
</tr>
</table>
<p style="font-size: 13px; color: #94A3B8;">此邮件由系统自动发出,请勿直接回复。</p>
</div>
"""
# 注意 _subtype 设置为 'html'
msg = MIMEText(html_content, _subtype='html', _charset='utf-8')
msg['Subject'] = Header("【日报】核心服务运行状态汇总", 'utf-8')
msg['From'] = Header(f"自动化运维 <{sender}>", 'utf-8')
msg['To'] = Header(";".join(receivers), 'utf-8')
with smtplib.SMTP_SSL(smtp_host, smtp_port, timeout=10) as server:
server.login(sender, auth_code)
server.sendmail(sender, receivers, msg.as_string())
print("HTML 邮件已投递!")
if __name__ == "__main__":
send_html_email()
六、必背核心代码三:多部件邮件(带附件发送实战)
带附件的邮件必须使用 MIMEMultipart('mixed') 作为复合根容器。先把文本或 HTML 正文作为子部件添加进去,再读取本地文件数据封装为 MIMEApplication 挂载到容器中。
附件处理最关键的两处细节:
- 必须添加标头
Content-Disposition并指定attachment; filename="..."。 - 附件名称包含中文时,接收方邮箱极易显示为乱码或
noname。必须使用Header(filename, 'utf-8').encode()进行标准转码。
import os
import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.application import MIMEApplication
from email.header import Header
def send_attachment_email(file_path):
smtp_host = "smtp.qq.com"
smtp_port = 465
sender = "your_email@qq.com"
auth_code = "abcdefghijklmnop"
receivers = ["receiver@example.com"]
# 1. 创建混合多部件根容器
msg = MIMEMultipart('mixed')
msg['Subject'] = Header("【数据报表】季度运营指标数据汇总", 'utf-8')
msg['From'] = Header(f"数据中心 <{sender}>", 'utf-8')
msg['To'] = Header(";".join(receivers), 'utf-8')
# 2. 挂载邮件正文子部件
body_text = MIMEText("附件为最新生成的统计报表,请查收附件文档。", 'plain', 'utf-8')
msg.attach(body_text)
# 3. 读取本地文件并挂载为附件
if os.path.exists(file_path):
filename = os.path.basename(file_path)
with open(file_path, 'rb') as f:
attachment = MIMEApplication(f.read())
# 针对中文文件名的标准化编码处理 (解决 noname 乱码问题)
attachment.add_header(
'Content-Disposition',
'attachment',
filename=('utf-8', '', filename)
)
msg.attach(attachment)
else:
print(f"附件文件不存在: {file_path}")
return
# 4. 执行加密发送
with smtplib.SMTP_SSL(smtp_host, smtp_port, timeout=15) as server:
server.login(sender, auth_code)
server.sendmail(sender, receivers, msg.as_string())
print("带附件邮件发送成功!")
if __name__ == "__main__":
# 示例:发送当前目录下的测试文件
send_attachment_email("quarterly_report.xlsx")
七、网络端口与安全协议选型(云服务器防坑必读)
很多开发者在本地电脑调试代码时一切正常,一旦部署到阿里云、腾讯云、华为云或 AWS 等云服务器上,脚本执行到 connect() 就会无限卡死,最终抛出 TimeoutError: [Errno 60] Operation timed out。这是因为几乎所有云服务商为了防止垃圾邮件泛滥,在底层物理防火墙上完全封禁了 TCP 25 端口的出站流量。
STARTTLS(端口 587)的标准代码写法
在对接微软 Office 365、谷歌 Gmail 或国际企业邮件系统时,常用 587 端口。587 端口遵循 RFC 3207 规范,它的机制是先建立普通连接,再通过显式命令 server.starttls() 升级为 TLS 加密通道:
import smtplib
from email.mime.text import MIMEText
from email.header import Header
# 端口 587 的标准写法 (区别于 465 的 SMTP_SSL)
def send_via_starttls():
smtp_host = "smtp.office365.com"
smtp_port = 587
sender = "user@domain.com"
auth_code = "App_Password_Here"
receivers = ["client@example.com"]
msg = MIMEText("这是通过 587 端口 STARTTLS 协议发送的邮件", 'plain', 'utf-8')
msg['Subject'] = Header("STARTTLS 协议测试", 'utf-8')
msg['From'] = Header(sender, 'utf-8')
msg['To'] = Header(";".join(receivers), 'utf-8')
with smtplib.SMTP(smtp_host, smtp_port, timeout=10) as server:
server.ehlo() # 1. 握手与服务能力协商
server.starttls() # 2. 显式升级为 TLS 加密会话
server.ehlo() # 3. 加密后再次确认身份
server.login(sender, auth_code)
server.sendmail(sender, receivers, msg.as_string())
print("STARTTLS 发送完成")
八、生产级异常诊断与排查决策
线上运行的定时任务和告警脚本必须具备细粒度的异常捕获机制,切忌直接写笼统的 except: pass。以下是 smtplib 体系中最常见的四类异常及其针对性解决方案:
• 535 Error: 99% 的概率是密码写成了邮箱的日常登录密码,或授权码字符串末尾带有复制进去的空格。
• SMTPServerDisconnected: 检查代码是否对 465 端口调用了普通的
smtplib.SMTP()。465 必须配合 SMTP_SSL。
• 550 / 554 垃圾邮件拦截: 检查
msg['From'] 的真实邮箱地址是否与 server.login(sender, ...) 中的 sender 绝对一致。国内各大邮箱会核验外层 Envelope Sender 与内层 MIME From 的一致性。
九、总结:开箱即用的模块化工具类
在实际项目中,建议将上述功能封装为一个健壮的独立邮件工具类,集成超时控制、连接管理与异常保护:
import smtplib
from email.mime.text import MIMEText
from email.header import Header
class MailSender:
def __init__(self, host: str, port: int, user: str, auth_code: str):
self.host = host
self.port = port
self.user = user
self.auth_code = auth_code
def send(self, to_addrs: list, title: str, body: str, is_html: bool = False) -> bool:
subtype = 'html' if is_html else 'plain'
msg = MIMEText(body, _subtype=subtype, _charset='utf-8')
msg['Subject'] = Header(title, 'utf-8')
msg['From'] = Header(f"通知助手 <{self.user}>", 'utf-8')
msg['To'] = Header(";".join(to_addrs), 'utf-8')
try:
with smtplib.SMTP_SSL(self.host, self.port, timeout=10) as server:
server.login(self.user, self.auth_code)
server.sendmail(self.user, to_addrs, msg.as_string())
return True
except smtplib.SMTPAuthenticationError:
print("[错误] 身份认证失败:请核对发件人与授权码")
except smtplib.SMTPServerDisconnected:
print("[错误] 连接意外中断:请检查端口与 SSL 协议匹配")
except smtplib.SMTPException as e:
print(f"[错误] SMTP 协议异常: {e}")
except Exception as e:
print(f"[错误] 系统异常: {e}")
return False
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









