官网:www.xservx.com | 服务热线:400-800-XXXX

Python发送邮件带附件

一、Python发送邮件带附件应用场景全景

在当前数字化办公与自动化运维体系中,Python发送邮件带附件已成为企业级系统、个人工具链及开源项目中不可或缺的基础能力模块。该技术广泛应用于以下关键场景:

据2025年Stack Overflow开发者调查数据显示,超68%的Python开发者在项目中使用邮件发送功能,其中82%涉及附件处理。这表明,掌握Python发送邮件带附件不仅是一项实用技能,更是提升系统专业度与用户信任度的关键环节。

为什么选择Python实现邮件附件发送?

⚡ 核心优势解析

  • 标准库支持完善:无需第三方依赖,smtplib与email模块提供企业级SMTP客户端与MIME构建能力
  • 类型安全可控:支持二进制附件、文本文件、图片、PDF、ZIP等任意格式,保持原始内容完整性
  • 高度可定制:可动态生成附件路径、文件名、MIME类型,适配复杂业务逻辑
  • 安全机制健全:原生支持SSL/TLS加密传输,兼容OAuth2等现代认证方式
  • 跨平台兼容:Linux/Windows/macOS系统下行为一致,部署无差异

二、核心模块深度剖析

Python发送邮件带附件依赖两大标准库协同工作:

  1. email模块:负责构建符合RFC 2822标准的邮件结构(MIME多部分消息)
  2. smtplib模块:实现SMTP协议通信,负责连接服务器、认证、发送数据

邮件结构的MIME分层模型

〈邮件内容结构树状图〉

  • MIMEMultipart(根节点)
    • MIMEText(正文文本部分)
      • plain:纯文本(text/plain)
      • html:富文本(text/html)
    • MIMEApplication(附件部分)
      • application/octet-stream:通用二进制流
      • application/pdf:PDF文档
      • image/png:PNG图片

这种分层设计确保邮件可被所有现代邮件客户端正确解析,避免内容错乱或附件丢失。

三、Python发送邮件带附件完整操作步骤

步骤1:准备SMTP服务器信息

不同邮箱服务商的SMTP配置参数差异显著,以下为常见平台关键参数:

邮箱服务商SMTP服务器地址端口(SSL)端口(TLS)授权方式
QQ邮箱smtp.qq.com465587客户端授权码
163邮箱smtp.163.com465587客户端授权码
Gmailsmtp.gmail.com465587应用专用密码
企业微信邮箱smtp.exmail.qq.com465587密码或授权码
Outlooksmtp.office365.com587587OAuth2或密码

步骤2:构建邮件内容(含附件)

from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.application import MIMEApplication
# 创建混合邮件容器
msg = MIMEMultipart()
msg['From'] = 'sender@example.com'
msg['To'] = 'receiver@example.com'
msg['Subject'] = '测试邮件:Python发送带附件'
# 添加正文(纯文本)
body = MIMEText('请查收附件中的测试文档。', 'plain', 'utf-8')
msg.attach(body)
# 添加PDF附件
with open('report.pdf', 'rb') as f:
    part = MIMEApplication(f.read(), _subtype='pdf')
    part.add_header('Content-Disposition', 'attachment', filename=('utf-8', '', '月度报告.pdf'))
    msg.attach(part)

步骤3:建立安全连接并发送

import smtplib
# 使用SSL加密连接(端口465)
server = smtplib.SMTP_SSL('smtp.qq.com', 465)
server.login('sender@qq.com', 'your_auth_code')  # 注意:非密码,是授权码
server.sendmail('sender@qq.com', ['receiver@example.com'], msg.as_string())
server.quit()

关键注意事项

四、多附件场景实战技巧

场景1:批量处理不同格式附件

高效添加多类型附件的通用函数

def add_attachments(msg, files):
    for filepath in files:
        with open(filepath, 'rb') as f:
            ext = filepath.split('.')[-1].lower()
            if ext in ['txt', 'csv', 'py', 'md']:
                part = MIMEText(f.read().decode('utf-8', errors='ignore'), 'plain', 'utf-8')
                part.add_header('Content-Disposition', 'attachment',
                               filename=('utf-8', '', filepath.split('/')[-1]))
            elif ext == 'pdf':
                part = MIMEApplication(f.read(), _subtype='pdf')
                part.add_header('Content-Disposition', 'attachment',
                               filename=('utf-8', '', filepath.split('/')[-1]))
            elif ext in ['png', 'jpg', 'jpeg']:
                from email.mime.image import MIMEImage
                part = MIMEImage(f.read(), _subtype='png' if ext=='png' else 'jpeg')
                part.add_header('Content-Disposition', 'attachment',
                               filename=('utf-8', '', filepath.split('/')[-1]))
            else:
                part = MIMEApplication(f.read())
                part.add_header('Content-Disposition', 'attachment',
                               filename=('utf-8', '', filepath.split('/')[-1]))
            msg.attach(part)
# 使用示例
files = ['report.pdf', 'data.csv', 'chart.png']
add_attachments(msg, files)

场景2:动态生成附件(无需物理文件)

直接从内存数据创建PDF附件

from reportlab.pdfgen import canvas
from io import BytesIO
# 生成PDF内存对象
buffer = BytesIO()
c = canvas.Canvas(buffer)
c.drawString(100, 750, "自动生成的测试报告")
c.drawString(100, 730, f"生成时间:2025年4月12日")
c.save()
buffer.seek(0)
# 附加到邮件
part = MIMEApplication(buffer.read(), _subtype='pdf')
part.add_header('Content-Disposition', 'attachment', filename=('utf-8', '', '动态报告.pdf'))
msg.attach(part)

五、HTML邮件与内嵌附件

为什么需要HTML邮件?

纯文本邮件在营销、通知类场景中显得生硬且信息密度低。HTML邮件支持:

构建HTML邮件的注意事项

⚠️ 邮件客户端渲染引擎差异大,需遵守以下原则:

  • 使用布局而非CSS Grid/Flexbox
  • 避免使用background-image
  • 所有样式内联(inline)
  • 使用基础HTML标签(img/a/b/i/ul/li)
  • HTML邮件与附件混合实例

    from email.mime.multipart import MIMEMultipart
    from email.mime.text import MIMEText
    from email.mime.application import MIMEApplication
    # 创建混合邮件
    msg = MIMEMultipart()
    msg['Subject'] = '项目周报(含HTML正文与PDF附件)'
    # 正文HTML内容(注意:必须使用内联样式)
    html = """

    项目周报(2025-04-08)

    尊敬的团队成员:

    本周工作重点如下:

    • 完成用户模块重构,性能提升40%
    • 修复登录态超时问题,解决率100%
    • 新增数据导出功能,支持PDF/CSV

    详细数据请查阅附件报告。

    —— 技术部

    """ # 添加HTML正文 html_part = MIMEText(html, 'html', 'utf-8') msg.attach(html_part) # 添加附件 with open('weekly_report.pdf', 'rb') as f: part = MIMEApplication(f.read(), _subtype='pdf') part.add_header('Content-Disposition', 'attachment', filename=('utf-8', '', '项目周报.pdf')) msg.attach(part)

    六、常见错误排查手册

    错误1:SMTPAuthenticationError(认证失败)

    • ✅ 确认使用“客户端授权码”而非邮箱登录密码
    • ✅ 检查SMTP服务是否已开启(QQ邮箱需在“设置→账户→POP3/IMAP/SMTP服务”中开启)
    • ✅ Gmail需启用“允许不够安全的应用”或使用应用专用密码
    • ✅ 检查邮箱是否被限制登录(如异地登录需短信验证)

    错误2:SMTPRecipientsRefused(收件人被拒绝)

    • ✅ 确认收件人邮箱地址格式正确(含@和域名)
    • ✅ 检查收件人邮箱服务器是否拒绝(如垃圾邮件过滤)
    • ✅ 尝试使用sendmail()的第三个参数to_addrs显式指定收件人列表

    错误3:附件名乱码或丢失

    • ✅ 文件名必须使用filename*=UTF-8''编码格式(RFC 2231)
    • ✅ 避免使用中文+特殊符号组合(如@#$%)
    • ✅ 对于旧版邮件客户端,可提供filename作为备选(带编码)

    调试技巧

    启用SMTP调试模式

    server = smtplib.SMTP_SSL('smtp.qq.com', 465)
    server.set_debuglevel(1)  # 开启调试输出
    server.login('sender@qq.com', 'auth_code')
    # ...后续操作

    调试模式将输出完整的SMTP交互过程,快速定位连接、认证、传输阶段问题。

    七、安全传输与合规要点

    SSL/TLS加密传输机制

    两种安全连接方式对比

    方式端口握手流程适用场景
    SMTPS(SSL)465连接即加密传统稳定方案
    STARTTLS(TLS)587明文连接后升级加密现代推荐方案

STARTTLS实现示例

server = smtplib.SMTP('smtp.qq.com', 587)
server.ehlo()
server.starttls()  # 升级为加密连接
server.ehlo()  # 重新发送EHLO
server.login('sender@qq.com', 'auth_code')

企业邮箱安全规范

  • 禁止硬编码密码:使用环境变量os.environ['SMTP_PASS']或配置文件
  • 限制发送频率:每分钟≤10封,避免触发风控
  • 启用SPF/DKIM/DMARC:在DNS中配置邮件认证记录,提升送达率
  • 签名验证:重要邮件使用PGP加密附件内容

环境变量安全配置示例

import os
from dotenv import load_dotenv
load_dotenv()  # 加载.env文件
SMTP_SERVER = os.getenv('SMTP_SERVER', 'smtp.qq.com')
SMTP_PORT = int(os.getenv('SMTP_PORT', 465))
SENDER_EMAIL = os.getenv('SENDER_EMAIL')
AUTH_CODE = os.getenv('AUTH_CODE')  # 不应明文存储!

八、自动化与定时发送方案

方案1:Linux crontab定时任务

配置步骤

  1. 创建Python脚本send_report.py(含邮件发送逻辑)
  2. 赋予执行权限:chmod +x send_report.py
  3. 编辑crontab:crontab -e
  4. 添加定时规则:0 9 * * 1 /usr/bin/python3 /path/to/send_report.py

方案2:Python内置调度器(无需系统级配置)

import schedule
import time
from datetime import datetime
def send_weekly_report():
    # ...邮件发送逻辑...
    print(f"【{datetime.now()}】周报已发送")
# 每周一上午9点执行
schedule.every().monday.at("09:00").do(send_weekly_report)
# 持续运行(生产环境建议用守护进程)
while True:
    schedule.run_pending()
    time.sleep(60)

高阶技巧:带重试机制的发送

import time
from tenacity import retry, stop_after_attempt, wait_exponential
@retry(stop=stop_after_attempt(3), wait=wait_exponential(multiplier=1, min=1, max=10))
def send_email_with_retry(msg):
    server = smtplib.SMTP_SSL('smtp.qq.com', 465)
    server.login(SENDER_EMAIL, AUTH_CODE)
    server.sendmail(SENDER_EMAIL, RECIPIENTS, msg.as_string())
    server.quit()
try:
    send_email_with_retry(msg)
    print("邮件发送成功!")
except Exception as e:
    print(f"3次重试后仍失败:{e}")

使用tenacity库实现指数退避重试,避免瞬时网络故障导致发送失败。

1. 能否同时发送HTML正文+内嵌图片?

可以!使用MIMEImage并设置Content-ID头,正文通过cid:image_id引用:

# 附加图片
with open('logo.png', 'rb') as f:
    img = MIMEImage(f.read())
    img.add_header('Content-ID', '<logo@xservx>')  # CID标记
    img.add_header('Content-Disposition', 'inline', filename='logo.png')
    msg.attach(img)
# HTML中引用
html = '''Logo'''
html_part = MIMEText(html, 'html', 'utf-8')
msg.attach(html_part)

2. 如何发送大附件(>25MB)?

⚠️ 主流邮箱对单封邮件附件总大小有限制(QQ邮箱25MB,Gmail25MB,Outlook20MB)

解决方案:

  • 压缩文件:使用zipfile打包多个附件
  • 分卷压缩:单文件>25MB时分割为多个小卷
  • 网盘链接替代:上传至腾讯云/阿里云OSS,邮件中附下载链接

3. 如何测试发送而不影响正式账号?

💡 推荐使用Mailtrap(https://mailtrap.io)等测试邮箱服务

配置SMTP指向Mailtrap服务器,所有邮件将捕获到测试收件箱,支持预览附件内容、检查编码、验证HTML渲染效果。

4. 企业微信/钉钉群机器人能否替代邮件?

群机器人适合实时通知,但无法替代邮件附件场景:

  • 群机器人不支持文件上传,仅支持文本/链接消息
  • 邮件具备正式性、可追溯性、法律效力
  • 邮件可长期归档,群消息易被刷屏覆盖

最佳实践:关键报告用邮件发送附件,进度同步用群机器人提醒。

5. 邮件发送后如何确认对方已读?

通过Disposition-Notification-To头请求回执,但需注意:

  • 仅当收件人客户端支持且用户同意时返回回执
  • 部分客户端(如Gmail)默认屏蔽回执请求
  • 更可靠的方式:在邮件正文中添加唯一追踪ID,结合访问日志分析

十、完整可运行示例代码

邮件发送器(含错误处理与日志)

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Python发送邮件带附件完整示例
功能:发送HTML正文+多类型附件,含错误重试与日志记录
"""
import smtplib
import logging
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.application import MIMEApplication
from email.utils import formataddr
from datetime import datetime
from pathlib import Path
# 配置日志
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
# 邮件配置
SMTP_CONFIG = {
    'server': 'smtp.qq.com',
    'port': 465,
    'sender': 'your_email@qq.com',
    'auth_code': 'your_auth_code',  # 替换为实际授权码
}
def create_email(subject, recipients, body_html, attachments=None):
    """创建带附件的邮件对象"""
    msg = MIMEMultipart()
    msg['From'] = formataddr(('技术部', SMTP_CONFIG['sender']))
    msg['To'] = ', '.join(recipients)
    msg['Subject'] = subject
    # 添加HTML正文
    msg.attach(MIMEText(body_html, 'html', 'utf-8'))
    # 添加附件
    if attachments:
        for filepath in attachments:
            path = Path(filepath)
            if not path.exists():
                logging.warning(f"附件不存在:{filepath}")
                continue
            with open(filepath, 'rb') as f:
                ext = path.suffix.lower()
                if ext == '.pdf':
                    part = MIMEApplication(f.read(), _subtype='pdf')
                elif ext in ['.png', '.jpg']:
                    from email.mime.image import MIMEImage
                    part = MIMEImage(f.read(), _subtype=ext[1:])
                else:
                    part = MIMEApplication(f.read())
                # 安全的文件名编码
                filename = path.name.encode('utf-8').decode('utf-8')
                part.add_header('Content-Disposition', 'attachment',
                               filename=('utf-8', '', filename))
                msg.attach(part)
    return msg
def send_email(msg):
    """发送邮件(带3次重试)"""
    try:
        with smtplib.SMTP_SSL(SMTP_CONFIG['server'], SMTP_CONFIG['port']) as server:
            server.login(SMTP_CONFIG['sender'], SMTP_CONFIG['auth_code'])
            server.sendmail(
                SMTP_CONFIG['sender'],
                msg['To'].split(', '),
                msg.as_string()
            )
        logging.info("邮件发送成功!")
        return True
    except Exception as e:
        logging.error(f"邮件发送失败:{e}")
        return False
if __name__ == '__main__':
    # 构建HTML正文
    body = """
    

项目周报(2025-04-12)

各位同事:

本周完成工作:

  • 修复登录态超时问题
  • 优化用户查询性能
  • 新增数据导出功能

详见附件报告。

—— 技术部

""" # 邮件参数 subject = "【重要】项目周报(2025-04-12)" recipients = ['team@example.com', 'manager@example.com'] attachments = ['report.pdf', 'data.csv'] # 创建并发送 msg = create_email(subject, recipients, body, attachments) send_email(msg)

运行前必读

  • 替换SMTP_CONFIG中的邮箱和授权码
  • 确保附件文件report.pdf和data.csv存在
  • 安装依赖:pip install python-dotenv tenacity schedule

十一、资源推荐

技术文档

工具推荐

  • Mailtrap:邮件测试平台
  • Postman:SMTP接口测试
  • Mailgun:第三方邮件服务(高送达率)

学习路径

  1. 掌握基础SMTP协议流程
  2. 实践发送纯文本邮件
  3. 添加单个附件并调试
  4. 构建HTML邮件
  5. 实现自动定时发送
  6. 集成到实际项目(如运维监控)