python必背源代码发邮件smtplib代码

竹里
竹里
发布时间:2026-11-17| 8人浏览过
原创

全面讲解Python使用内置标准库smtplib与email发送邮件的必背核心源代码。包含纯文本邮件、HTML格式邮件及附件发送实战,详解授权码配置、465与587端口加密协议选型及云服务器常见报错排查。

在 Python 自动化运维、定时巡检、报表推送以及业务系统告警中,使用代码发送邮件是一项高频且基础的操作。Python 标准库自带了 smtplib 与 email 两个模块,无需执行任何 pip install 即可直接完成纯文本、富文本 HTML 以及多格式附件的发送。实现邮件发送的核心逻辑非常明确:使用 email.mime 组装符合网络协议规范的报文结构,再通过 smtplib 建立加密通道并投递到目标邮箱服务器。本文提供可以直接复用、符合生产级规范的必背源码,并拆解授权码机制、端口协议差异与云服务器部署避坑要点。

python必背源代码发邮件smtplib代码
图 0:Python 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),并将封装好的报文推送到目标服务器。
python必背源代码发邮件smtplib代码
图 1:Python 邮件发送全链路架构:MIME 报文构建与 SMTP 协议传输

三、必背核心代码一:发送纯文本邮件(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 的程序都严格遵循这四个标准阶段:

python必背源代码发邮件smtplib代码
图 2:Python 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 挂载到容器中。

附件处理最关键的两处细节:

  1. 必须添加标头 Content-Disposition 并指定 attachment; filename="..."。
  2. 附件名称包含中文时,接收方邮箱极易显示为乱码或 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 端口的出站流量。

python必背源代码发邮件smtplib代码
图 3:SMTP 发送端口与加密协议选型对比指南

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 体系中最常见的四类异常及其针对性解决方案:

python必背源代码发邮件smtplib代码
图 4:Python 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
相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。