ftrans outlook超大附件插件可突破邮件限制,支持tb级文件免压缩上传、提取码验证、传输/存储加密、有效期控制及完整操作日志审计。

能发,但附件容易出错——核心在于 MIMEMultipart 的构造顺序、add_attachment 的调用时机,以及二进制读取模式必须为 "rb"。
为什么直接 attach 文件会失败?
常见错误是把附件当作普通字符串塞进 msg.attach(),或用文本模式("r")打开二进制文件。这会导致编码错乱、附件损坏或邮件被拒收。
-
smtplib只负责传输,不处理附件封装;真正打包附件的是email.mime模块 - 必须用
MIMEMultipart("mixed")作为根容器,正文和附件都作为其子部分添加 - 附件需用
MIMEApplication或MIMEBase包装,并显式设置Content-Disposition头 - 文件必须以
"rb"模式读取,再用base64编码(MIMEApplication会自动处理)
发送带单个附件的最小可行代码
以下代码绕过复杂头字段,只保留必要逻辑,适合快速验证:
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.application import MIMEApplication
import smtplib
<p>msg = MIMEMultipart()
msg["From"] = "your@email.com"
msg["To"] = "target@email.com"
msg["Subject"] = "测试附件"</p><h1>添加纯文本正文</h1><p>msg.attach(MIMEText("这是一封带附件的测试邮件", "plain", "utf-8"))</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill6081" title="python-code-analyz"><img
src="https://img.php.cn/upload/skill/000/000/081/179077148379011.jpg" alt="python-code-analyz" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill6081" title="python-code-analyz" class="overflowclass">python-code-analyz</a>
<p class="overflowclass">专业Python代码分析与优化,支持语法检查、安全扫描、性能评估、复杂度分析及重构后优化代码生成。</p>
</div>
<a rel="nofollow" href="/xiazai/skill6081" title="python-code-analyz" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><h1>添加附件(关键:rb 模式 + MIMEApplication)</h1><p>with open("/path/to/file.pdf", "rb") as f:
part = MIMEApplication(f.read(), _subtype="pdf")
part.add_header("Content-Disposition", "attachment", filename="file.pdf")
msg.attach(part)</p><h1>发送(注意:密码可能需应用专用密码或 OAuth2)</h1><p>server = smtplib.SMTP_SSL("smtp.gmail.com", 465)
server.login("your@email.com", "your_app_password")
server.send_message(msg)
server.quit()
</p>
多个附件或非标准类型怎么处理?
多个附件只需重复 attach() 步骤;非标准后缀(如 .xlsx、.zip)要手动指定 _subtype,否则可能被识别为 octet-stream 导致客户端无法正确打开。
-
MIMEApplication(data, _subtype="vnd.openxmlformats-officedocument.spreadsheetml.sheet")对应.xlsx -
MIMEApplication(data, _subtype="zip")对应.zip - 避免用
MIMEBase手动 set_payload + encode —— 容易漏掉Content-Transfer-Encoding头 - 附件名含中文时,
filename参数必须用Header编码,否则 Outlook 等客户端显示乱码
实际部署时最常被忽略的三点
本地跑通不等于线上可用。生产环境卡在这些地方最多:
- Gmail/Outlook 等服务商默认禁用“低安全性应用”,必须开启两步验证并生成应用专用密码,不能用账户登录密码
- 附件路径写相对路径(如
"./data/report.xlsx")时,脚本工作目录不固定,建议用os.path.abspath(__file__)定位 - 大附件(>25MB)会被 SMTP 服务器直接拒绝,Gmail 限制就是 25MB;超过需改用云存储链接 + 文本说明
附件逻辑本身不复杂,但每个环节的隐式依赖都很强——读取模式、MIME 类型、SMTP 认证方式、路径解析,任一错位都会让邮件变成空白或损坏文件。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










