Flask-Mail附件发送失败主因是路径错误、MIME类型不匹配及SMTP权限未配置；须用绝对路径+os.path.exists校验、二进制读取、正确填写attach三参数，并启用应用专用密码与调试日志。
附件文件路径错误导致 FileNotFoundError
Flask-Mail 本身不处理附件读取，它只负责把已打开的文件对象传给底层邮件库。常见错误是直接传入字符串路径（比如 "./files/report.pdf"），结果在 Message.attach() 时抛出 FileNotFoundError —— 因为 Flask 应用工作目录不一定是你预期的位置，尤其部署后更不可靠。
- 始终用
os.path.join(app.root_path, "static", "files", "report.pdf")构造绝对路径，避免相对路径陷阱 - 发送前先用
os.path.exists()检查文件是否存在，否则直接报错难定位 - 附件内容必须以二进制模式打开：
with open(path, "rb") as f: f.read()，不能用文本模式
Message.attach() 的三个必需参数怎么填
Message.attach() 要求三个位置参数：文件名（filename）、MIME 类型（content_type）、原始字节（data）。漏掉或顺序错会直接报 TypeError。
-
filename是收件人看到的文件名，可以和磁盘名不同，比如"monthly_report_2024.pdf" -
content_type不能靠猜，PDF 用"application/pdf"，Excel 用"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"，图片用"image/png"等 -
data必须是bytes，不是文件路径也不是 file object；常用写法：f.read()或Path("...").read_bytes()
多个附件怎么加？别重复用同一个 Message 实例
一个 Message 对象可多次调用 .attach()，但必须在 mail.send() 之前完成。常见错误是循环中新建 Message，导致只有最后一个附件生效。
- 正确做法：先构建
msg = Message(...)，再循环调用msg.attach()，最后统一mail.send(msg) - 注意内存：大附件（>5MB）建议流式读取或分块，避免一次性加载到内存引发
MemoryError - 如果附件来自用户上传（
request.files），直接用file.stream.read()获取 bytes，别先保存到磁盘
SMTP 配置没开二步验证或应用密码，发信直接静默失败
本地调试时用 Gmail 或 Outlook SMTP，mail.send() 可能不报错但邮件根本没发出——因为账号没开“应用专用密码”或 SMTP 权限被禁用。
立即学习“Python免费学习笔记（深入）”；
- Gmail 必须开启“两步验证”，再生成“应用专用密码”，用这个密码替代账号密码填入
MAIL_PASSWORD - Outlook/Hotmail 同样需在安全设置里启用 SMTP，并用应用密码
- 测试时加
mail.debug = True和app.config["MAIL_DEBUG"] = True，能看到底层 SMTP 交互日志
附件发送真正卡住的地方，往往不在代码逻辑，而在路径、MIME 类型、SMTP 权限这三处。每一步都建议加 print() 或日志输出关键变量，比盲猜快得多。
