企业级邮件自动发送系统需确保稳定、可达、可追溯且不被误判为垃圾邮件；Python的smtplib和email库可用，但须显式配置端口与加密方式、规范处理中文附件名编码、控制并发与重试机制，并以二进制模式读取非文本附件。
企业级邮件自动发送系统，核心不在“发得出去”，而在“发得稳、收得到、可追溯、不被当垃圾邮件”。Python 的 smtplib 和 email 标准库完全能撑住，但直接套用示例代码发附件，90% 会卡在编码、MIME 结构或 SMTP 认证上。
SMTP 连接必须显式指定端口与加密方式，不能依赖默认行为
很多教程写 smtplib.SMTP("smtp.exmail.qq.com") 就完事，实际会报 Connection refused 或认证失败。腾讯企业邮箱、阿里云邮件推送、Office 365 等服务对端口和 TLS/SSL 要求严格，且不同服务商策略不同：
- 腾讯企业邮箱：用
SMTP_SSL+ 端口465，或starttls()+ 端口587；SMTP类本身不加密，直接连 587 会握手失败 - 阿里云邮件推送：强制要求
SMTP_SSL+465，且需开启“SMTP 服务”并生成专用密码（非登录密码） - 本地 Postfix 或自建邮件网关：可能只支持
starttls()，禁用 SSL
实操建议始终显式选择：
server = smtplib.SMTP_SSL("smtp.exmail.qq.com", 465) # 或
server = smtplib.SMTP("smtp.exmail.qq.com", 587)
server.starttls()附件中文名乱码？本质是 MIME header 编码没做对
用 MIMEApplication 或 MIMEBase 加附件时，如果文件名含中文，收件方 Outlook 或 Webmail 常显示为 =?utf-8?b?...?= 或直接截断。这不是 Python bug，是 RFC 2231 规定的 header 编码规则没遵守：
立即学习“Python免费学习笔记（深入）”；
- 不能直接赋值
part.add_header("Content-Disposition", f"attachment; filename={filename}") - 必须用
email.utils.encode_header或手动构造Content-Disposition头 - 更稳妥的做法：用
MIMEText+MIMEApplication组合，并调用set_param设置编码
简例：
with open("报告_2024Q3.pdf", "rb") as f:
part = MIMEApplication(f.read(), _subtype="pdf")
part.add_header("Content-Disposition", "attachment",
filename=("utf-8", "", "报告_2024Q3.pdf")) # 注意三元组格式大批量发送必须控制并发与重试，否则触发风控封 IP
企业场景常需单次发 500+ 封邮件，若用循环直连 SMTP 发送，大概率被服务商限流（如腾讯企业邮箱限制 200 封/小时，阿里云默认 100 封/分钟），甚至 IP 被加入黑名单。标准库本身不提供队列或退避机制：
- 单连接最多发 50–100 封后主动
quit()并重建连接（避免会话超时或内存泄漏） - 每封失败邮件记录
SMTPRecipientsRefused或SMTPDataError，按错误类型分级重试（如 4xx 错误不重试，5xx 可重试 2 次） - 并发数严格限制在 3–5（取决于服务商允许的并发连接数），用
concurrent.futures.ThreadPoolExecutor控制，别用asyncio——smtplib同步阻塞，异步反而增加复杂度
附件路径与二进制读取容易忽略文件打开模式
常见错误是用 open("file.xlsx") 默认文本模式读 Excel/PDF/ZIP，导致 UnicodeDecodeError 或附件损坏。所有非文本附件必须用 "rb" 模式打开：
-
.xlsx,.pdf,.zip,.docx→ 一律open(path, "rb") - 文本类附件（如
.csv,.log）若需保留原始编码，也建议用"rb"，再按需 decode，避免平台换行符干扰 - 路径含中文或特殊字符时，Windows 下用
pathlib.Path比字符串拼接更可靠，且能提前捕获FileNotFoundError
附件处理最易被绕过的细节：不是“能不能加”，而是“加进去之后，收件方能否原样解码打开”。一个 filename 参数写错，整批邮件就被当成无附件的纯文本——这种问题在线上环境里，只能靠收件方反馈才发现。
