Python发送邮件带附件

—— 实用指南与深度解析
当前位置:首页 > 基础入门 > 实战案例 网址:www.xservx.com

Python发送邮件带附件:全流程详解

在现代自动化办公与系统运维场景中,Python发送邮件带附件已成为一项高频刚需操作。无论是定期生成报表并自动发送、用户注册验证、异常告警通知,还是批量处理合同文件交付,邮件附件功能都扮演着不可替代的角色。本页面将从底层协议原理到高阶实践技巧,系统讲解Python实现带附件邮件的完整技术链路,涵盖SMTP协议机制、MIME标准构建、编码规范、常见陷阱与安全加固策略。

不同于传统教程仅展示基础代码,本文结合真实业务场景,提供:
• SMTP协议通信全流程解析
• MIME消息结构深度拆解
• 多种附件类型(文本/二进制/图片/PDF)的编码处理
• SSL/TLS加密连接实战
• 错误码定位与日志追踪技巧
• 企业级安全防护建议
• 周边技术(如HTML邮件、模板渲染)扩展

全文超过3000字,内容结构化、示例可运行、技术点无跳跃,适配Python 3.7+环境,助您彻底掌握Python发送邮件带附件的核心技能。

核心模块概览

  • smtplib:处理SMTP协议通信,负责建立连接、登录、发送指令与数据
  • email:构建邮件内容结构,包括主题、正文、附件的MIME封装
  • ssl:提供SSL/TLS加密通道,保障传输安全
  • os & mimetypes:辅助读取本地文件与识别MIME类型

关键点:所有邮件内容必须符合MIME标准,不能直接拼接字符串发送——这是初学者常见误区。

典型应用场景

  • 运维监控系统:自动发送故障日志压缩包(.tar.gz)
  • 财务系统:每月发送PDF格式报表(.pdf)至管理层邮箱
  • 招聘平台:向候选人发送带PDF附件的录用通知
  • 数据团队:定期推送清洗后的CSV数据文件(.csv)
  • 教育平台:学生结业证书扫描件(.jpg/.pdf)自动发放

一、SMTP协议与邮件传输原理

SMTP(Simple Mail Transfer Protocol)是用于发送邮件的标准协议,工作在TCP/IP层之上,默认端口25。但现代服务提供商(如Gmail、QQ邮箱、企业邮箱)普遍要求加密连接,因此常用端口为:

  • 465:SMTPS(SMTP over SSL)——全程加密
  • 587:SMTP with STARTTLS——明文升级为加密
  • 25:传统端口,多数被ISP屏蔽

邮件传输过程包含三个关键阶段:

阶段分解

  1. 连接建立:客户端 → SMTP服务器(如smtp.qq.com)
  2. 身份认证:通过Base64编码的用户名与授权码(非登录密码)
  3. 数据提交:包含信封信息(MAIL FROM/RCPT TO)与邮件内容(DATA)

邮件结构规范

一封标准邮件由以下部分组成:

头部字段(Headers)

  • From:发件人地址
  • To:收件人地址(可多收件人)
  • Subject:邮件主题
  • Date:发送时间(RFC822格式)
  • MIME-Version:MIME版本号(必须为1.0)
  • Content-Type:内容类型与边界标识(boundary)

主体部分(Body)

主体以分隔符(boundary)分隔为多个部分(multipart),常见类型:

  • multipart/mixed:混合内容(正文+附件)
  • multipart/alternative:同一内容多格式(如text/plain + text/html)

关键点:附件必须作为独立MIME部分,使用Content-Disposition: attachment声明,并通过Content-Transfer-Encoding指定编码方式(Base64最通用)。

二、环境准备与配置

确保系统已安装Python 3.7+。无需额外安装第三方库,Python标准库已包含所需模块:

python3 --version
# 输出示例:Python 3.10.6

邮箱服务授权设置

以QQ邮箱为例(其他邮箱类似):

  1. 登录QQ邮箱 → 设置 → 账户
  2. 下滑至“POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”
  3. 开启“SMTP服务”并按提示发送短信验证
  4. 记录生成的“授权码”——这是后续登录凭证

重要提醒:授权码 ≠ 登录密码!使用密码会导致认证失败。

SMTP服务器地址速查

服务商SMTP服务器端口
QQ邮箱smtp.qq.com465(SSL)
163邮箱smtp.163.com465(SSL)
Gmailsmtp.gmail.com465(SSL)
企业邮箱smtp.company.com465/587

安全警告

⚠️ 警告

切勿在代码中硬编码邮箱密码或授权码!建议通过环境变量或配置文件读取:

import os
email_user = os.getenv("EMAIL_USER")
email_pass = os.getenv("EMAIL_PASS")

三、基础实战:纯文本邮件(无附件)

作为前置步骤,先实现无附件邮件,验证基础连接能力:

import smtplib
from email.mime.text import MIMEText
from email.header import Header
# 配置参数
smtp_server = "smtp.qq.com"
smtp_port = 465
sender = "your_email@qq.com"
password = "your_auth_code"  # 替换为授权码
receiver = "recipient@example.com"
# 构建邮件内容
msg = MIMEText("这是一封测试邮件,用于验证Python SMTP功能。", "plain", "utf-8")
msg["From"] = Header("Python测试系统", "utf-8")
msg["To"] = Header("收件人", "utf-8")
msg["Subject"] = Header("测试邮件", "utf-8")
# 发送邮件
with smtplib.SMTP_SSL(smtp_server, smtp_port) as server:
    server.login(sender, password)
    server.sendmail(sender, [receiver], msg.as_string())
    print("邮件发送成功!")

关键代码解析

1. MIMEText构造

MIMEText(content, subtype, charset)中:
• content:正文文本
• subtype:可选"plain"(纯文本)或"html"(HTML)
• charset:必须为"utf-8"避免中文乱码

2. Header对象

用于编码非ASCII字符(如中文),防止头部字段被截断

3. SMTP_SSL上下文

使用with语句确保连接自动关闭,避免资源泄漏

常见错误排查

错误类型1:smtplib.SMTPAuthenticationError

原因:授权码错误或未开启SMTP服务
解决:检查授权码是否复制正确,确认服务已开启

错误类型2:smtplib.SMTPServerDisconnected

原因:端口被防火墙屏蔽或服务器拒绝连接
解决:尝试切换端口(465→587),检查网络环境

四、核心技能:带附件邮件的完整实现

带附件邮件需使用MIMEMultipart构建多部分结构,步骤如下:

步骤1:创建混合类型容器

使用MIMEMultipart("mixed")作为根容器,用于承载正文与附件。

步骤2:添加正文部分

创建MIMEText对象并附加到容器:

text_part = MIMEText("详情请见附件报告。", "plain", "utf-8")
msg.attach(text_part)

步骤3:处理附件

通用流程:读取文件 → 设置MIME类型 → Base64编码 → 添加到容器

import mimetypes
from email.mime.base import MIMEBase
from email import encoders
# 识别文件类型
file_path = "report.pdf"
mime_type, _ = mimetypes.guess_type(file_path)
if mime_type is None:
    mime_type = "application/octet-stream"
maintype, subtype = mime_type.split("/")
# 创建附件对象
with open(file_path, "rb") as f:
    file_part = MIMEBase(maintype, subtype)
    file_part.set_payload(f.read())
# Base64编码
encoders.encode_base64(file_part)
# 添加头部信息
file_part.add_header(
    "Content-Disposition",
    "attachment",
    filename=("utf-8", "", "报告.pdf")
)
msg.attach(file_part)

完整示例代码

import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email import encoders
from email.header import Header
import mimetypes
# 配置参数
smtp_server = "smtp.qq.com"
smtp_port = 465
sender = "your_email@qq.com"
password = "your_auth_code"
receiver = "recipient@example.com"
# 创建混合容器
msg = MIMEMultipart("mixed")
msg["From"] = Header("Python报告系统", "utf-8")
msg["To"] = Header("收件人", "utf-8")
msg["Subject"] = Header("2024年第一季度销售报告", "utf-8")
# 添加正文
text = MIMEText("您好!

随信附上2024年第一季度销售报告PDF文件。

如有疑问,请随时联系。

—— 技术部", "html", "utf-8") msg.attach(text) # 添加附件 file_path = "Q1_Sales_Report.pdf" mime_type, _ = mimetypes.guess_type(file_path) if mime_type is None: mime_type = "application/octet-stream" maintype, subtype = mime_type.split("/") with open(file_path, "rb") as f: file_part = MIMEBase(maintype, subtype) file_part.set_payload(f.read()) encoders.encode_base64(file_part) file_part.add_header( "Content-Disposition", "attachment", filename=("utf-8", "", "Q1销售报告.pdf") ) msg.attach(file_part) # 发送邮件 with smtplib.SMTP_SSL(smtp_server, smtp_port) as server: server.login(sender, password) server.sendmail(sender, [receiver], msg.as_string()) print("✅ 邮件发送成功!")

多附件支持

循环添加多个附件:

for file in ["report.pdf", "data.xlsx", "summary.docx"]:
    # 复用上述附件处理逻辑
    # 注意:每次需重新创建MIMEBase对象

图片附件的特殊处理

若需内嵌图片(如HTML正文中的标签),需使用MIMEImage并设置Content-ID:

from email.mime.image import MIMEImage
# 添加图片附件
with open("logo.png", "rb") as f:
    img_part = MIMEImage(f.read(), _subtype="png")
    img_part.add_header("Content-ID", "")  # 注意尖括号
    img_part.add_header("Content-Disposition", "inline", filename="logo.png")
    msg.attach(img_part)
# HTML中引用
html = MIMEText('', "html", "utf-8")
msg.attach(html)

五、常见问题与排错指南

1. 中文附件名乱码

问题:附件下载后显示为=?utf-8?B?...?=.pdf

解决方案:使用filename*=格式(RFC2231):

file_part.add_header(
    "Content-Disposition",
    "attachment",
    filename*= "utf-8''报告.pdf"
)

2. 大文件传输超时

问题:附件>25MB时发送失败(多数邮箱限制25MB)

解决方案:

  • 压缩文件(使用zipfile模块)
  • 分卷压缩(单卷≤20MB)
  • 使用云盘链接替代附件(需提前上传)

3. 邮件被标记为垃圾邮件

原因与对策:

发件人域名未做SPF/DKIM认证

在DNS中添加SPF记录,并配置DKIM签名(需企业邮箱支持)

正文含敏感词(如“免费”“ guaranteed”)

避免营销化用语,使用中性描述

HTML邮件结构不规范

确保有完整,避免内联CSS过多

4. 多收件人失败

问题:仅部分收件人收到邮件

检查点:

  • sendmail()的第二个参数必须是列表:[addr1, addr2]
  • 确保所有邮箱地址格式正确(含@)
  • 部分邮箱(如Gmail)会静默丢弃无效地址

六、安全加固策略

1. 授权码保护

使用Python-dotenv管理环境变量:

.env文件:
EMAIL_USER=your_email@qq.com
EMAIL_PASS=your_auth_code
代码中:
from dotenv import load_dotenv
load_dotenv()
email_user = os.getenv("EMAIL_USER")

2. 启用STARTTLS(非SSL)

适用于支持STARTTLS的服务器(端口587):

server = smtplib.SMTP(smtp_server, 587)
server.ehlo()
server.starttls()  # 升级为加密连接
server.ehlo()
server.login(sender, password)

3. 防止SQL注入式攻击

对用户输入的收件人地址做严格校验:

import re
def is_valid_email(email):
    pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'
    return bool(re.match(pattern, email))
if not is_valid_email(receiver):
    raise ValueError("无效的邮箱地址")

七、网友最关心的10个问题

Q1:如何发送HTML格式正文?
Q2:附件名含空格会怎样?
Q3:能同时发送给多人吗?
Q4:如何设置抄送(CC)?
Q5:发送失败后如何重试?
Q6:Python支持发送ZIP压缩包吗?
Q7:如何避免附件被杀毒软件拦截?
Q8:macOS/Linux下中文路径乱码?
Q9:能发送邮件模板吗?
Q10:企业微信/钉钉能接收吗?

A:修改MIMEText的subtype参数为"html",并确保HTML结构完整:

html_content = """
    

报告概览

详情请见附件。

""" msg.attach(MIMEText(html_content, "html", "utf-8"))

A:需对文件名进行URL编码,使用filename*格式可自动处理:

file_part.add_header(
    "Content-Disposition",
    "attachment",
    filename*= "utf-8''Q1 销售报告.pdf"
)

A:可以,将收件人列表传入sendmail():

receivers = ["user1@example.com", "user2@example.com"]
server.sendmail(sender, receivers, msg.as_string())

A:在MIMEMultipart头部添加Cc字段:

msg["Cc"] = "cc@example.com"
# 注意:sendmail()的收件人列表需包含CC地址
all_receivers = [receiver, "cc@example.com"]
server.sendmail(sender, all_receivers, msg.as_string())

A:实现指数退避重试:

A:支持!先压缩再作为二进制附件发送:

import zipfile
with zipfile.ZipFile("report.zip", "w") as zf:
    zf.write("report.pdf")
    zf.write("data.xlsx")
# 之后按常规附件方式添加report.zip

A:避免以下行为:

  • 附件扩展名与内容不匹配(如.exe伪装为.jpg)
  • 压缩包内含可执行文件(.bat/.exe)
  • 附件名含“setup”“install”等敏感词

建议:对压缩包设置密码(需提前约定)

A:使用os.path.basename()提取文件名,避免路径编码问题:

file_name = os.path.basename(file_path)  # 仅保留文件名
file_part.add_header("Content-Disposition", "attachment", filename=("utf-8", "", file_name))

A:使用Jinja2模板引擎:

from jinja2 import Template
template = Template("您好 {{name}},附件为 {{title}}。")
content = template.render(name="张三", title="月度报告")
msg.attach(MIMEText(content, "plain", "utf-8"))

A:企业微信/钉钉支持接收邮件,但需配置:
• 企业微信:在“我的企业”→“微信接收邮件”中绑定邮箱
• 钉钉:使用“邮件机器人”接收邮件并转发到群聊