当前位置:

首页 > 编程开发 > Python用smtplib发邮件的完整步骤

Python用smtplib发邮件的完整步骤

邮件发送失败常见原因包括:未使用邮箱授权码而直接使用登录密码;SMTP服务器地址或端口配置错误(如QQ邮箱应使用smtp.qq.com:465用于SSL);网络或防火墙限制导致无法连接;邮件内容被识别为垃圾邮件;邮箱地址拼写错误。2.发送带附件或HTML内容的邮件需使用email模块的MIME组件:HTML内容通过MIMEText(content,'html','utf-8')实现;附件需读取为二进制数据,用MIMEBase封装并Base64编码,再通过Content-Disposition头设置为附件。

本文目录

    邮件发送失败常见原因包括:未使用邮箱授权码而直接使用登录密码;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模块完整流程

    使用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()方法断开与服务器的连接,释放资源。

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

    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格式的邮件,来自Python脚本。

    希望你喜欢!

    Python Logo """ 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中包含内联图片(https://img.zhengruan.com/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', '') # 这里的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已经足够强大。但一旦涉及到“大批量”这个词,就得认真考虑专业的邮件服务了,它们不仅能解决发送效率和送达率的问题,还能提供详细的发送报告和统计分析,这些都是自己搭建无法比拟的优势。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 Python Python编程
    相关文章 更多
    python删除一个列表里的重复元素的方法与代码示例
    python删除一个列表里的重复元素的方法与代码示例

    学习如何使用Python高效删除列表中的重复元素。本文提供5种常见方法的代码示例,涵盖保持顺序与不保持顺序的场景,适合初学者和进阶开发者参考。

    Python写接口的步骤及完整代码示例
    Python写接口的步骤及完整代码示例

    详细讲解使用Python编写Web接口的核心步骤与完整代码示例,涵盖环境准备、路由定义、数据校验、服务启动及调试测试方法。

    codex怎么读取word文档及docx文件操作教程
    codex怎么读取word文档及docx文件操作教程

    介绍如何利用编程工具读取和解析Word文档(docx格式),涵盖基础文本提取代码示例、结构化数据处理逻辑,以及处理复杂排版时的技术局限与替代方案。

    怎么在Python中调用C语言代码提升性能
    怎么在Python中调用C语言代码提升性能

    详细讲解在Python中调用C语言代码提升性能的完整实践指南,包含原理分析、编译步骤、ctypes与CFFI具体实现、性能对比及常见陷阱。

    Python与C语言的性能差异及底层原理
    Python与C语言的性能差异及底层原理

    深入解析Python与C语言在执行效率上的数量级差异,从编译机制、变量内存布局、动态类型推断到GIL锁,系统阐明底层核心原理。

    Python和C语言哪个更适合编程入门
    Python和C语言哪个更适合编程入门

    客观对比Python与C语言在心智负担、底层机制与学习反馈上的核心差异,提供清晰有据的选择标准与切实的入门学习路径。

    selenium上传文件教程本地文件路径设置方法
    selenium上传文件教程本地文件路径设置方法

    深入解析Selenium处理文件上传的技术细节,涵盖标准HTML控件的路径直接注入法与非标准控件的系统级模拟方案,提供Windows与Linux环境下的路径设置最佳实践及常见异常排查。

    大数据开发语言选型:Java对比Scala与Python的优缺点及适用场景
    大数据开发语言选型:Java对比Scala与Python的优缺点及适用场景

    针对大数据工程场景,系统对比Java、Scala与Python在执行性能、生态结合、开发效率和维护成本上的核心差异,给出清晰的架构选型依据与落地方案。

    langgraph python guide中文入门教程详解
    langgraph python guide中文入门教程详解

    本篇LangGraph Python中文入门教程详解,系统梳理StateGraph状态机定义、节点编写、边与条件路由、检查点持久化(MemorySaver)等核心机制,提供从环境安装到完整循环智能体构建的代码示例与实操指导。

    Windows 安装 Python:从官方入口到虚拟环境的可复现实践
    Windows 安装 Python:从官方入口到虚拟环境的可复现实践

    面向后端开发者,基于 Python 官方文档说明如何在 Windows 上安装 Python、创建 venv 虚拟环境及使用 pip 管理依赖。包含可复制命令、验证方法及工具选择边界,避免常见配置误区。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。