Python email.mime库正文文本偶发转为附件问题求助

我用Python的email.mime库生成跨多站点的系统状态监控邮件，按照文档示例添加正文文本，多数站点能正常显示，但在部分站点，正文会被转换成无类型附件。对比正常和异常邮件的原始格式，差异如下：

---===============1782456183745610843756==
-Content-Type: text/plain; charset="us-ascii"; name="ATT00001"
+--===============4561084375674561084375==
+Content-Type: text/plain; charset="us-ascii"
 MIME-Version: 1.0
 Content-Transfer-Encoding: 7bit
-Content-Description: ATT00001
-Content-Disposition: attachment; filename="ATT00001"

生成邮件的代码完全一致，推测是站点特定参数导致的差异，有没有人遇到过类似问题？

这种情况很常见，核心原因是部分站点的邮件网关或客户端对MIME头的解析规则更严格：当text/plain类型的内容带有name属性，或者被设置了Content-Disposition: attachment头时，会被判定为附件而非正文。

解决思路： #

1. 清理多余的MIME头
   确保正文对应的MIMEText对象没有添加name参数，也不要设置Content-Disposition: attachment。正文默认的Content-Disposition是inline，不需要额外指定，除非有特殊需求。

2. 规范MIME对象构建逻辑
   避免误加导致附件判定的头，正确的正文构建示例：

   from email.mime.text import MIMEText
   from email.mime.multipart import MIMEMultipart
   
   # 单文本邮件场景
   msg = MIMEText("系统监控状态详情...", 'plain', 'utf-8')
   
   # 带附件的多部分邮件场景
   msg = MIMEMultipart()
   # 正文需放在附件之前，默认即为inline类型
   body = MIMEText("系统监控状态详情...", 'plain', 'utf-8')
   msg.attach(body)
   # 后续添加附件的逻辑
   # attachment = MIMEText(open('report.txt', 'r').read(), 'plain')
   # attachment.add_header('Content-Disposition', 'attachment', filename='report.txt')
   # msg.attach(attachment)
   

3. 统一字符编码
   尽量使用utf-8编码而非us-ascii，部分老旧邮件系统对非ASCII字符的处理可能触发异常头的自动添加。

补充说明 #

即使发送端代码一致，不同站点的邮件过滤网关可能会自动修改MIME头（比如为无附件的邮件添加默认附件标记），但通过规范发送端的MIME结构，可以最大程度规避这类问题。

内容的提问来源于stack exchange，提问作者matt