Python邮件发送中缺失主题（Missing Subject）的解决方案

使用email.message.EmailMessage构建邮件时，若调用smtplib.SMTP.sendmail()直接传入纯文本内容而非完整邮件对象，会导致主题、发件人等头部信息丢失；正确做法是通过msg.set_content()填充正文，并统一使用server.send_message(msg)发送完整消息对象。

使用`email.message.emailmessage`构建邮件时，若调用`smtplib.smtp.sendmail()`直接传入纯文本内容而非完整邮件对象，会导致主题、发件人等头部信息丢失；正确做法是通过`msg.set_content()`填充正文，并统一使用`server.send_message(msg)`发送完整消息对象。

在 python 自动化邮件通知场景中（如每日天气报告），一个常见却易被忽视的问题是：邮件成功发出，但收件箱中显示“（no subject）”——即主题栏为空。根本原因并非代码漏写 msg[‘Subject’]，而是消息构造与发送方式不匹配。

回顾原始实现，问题出在第二段脚本的最后两行：

server.sendmail(sender_email, receiver_email, file_content, msg)

该调用形式存在严重误用：

• smtplib.SMTP.sendmail() 的标准签名是 sendmail(from_addr, to_addrs, msg_as_string)；
• 第三个参数必须是已序列化为 RFC 5322 格式的完整邮件字符串（含所有头部和空行分隔）；
• 但此处传入的是纯文本文件内容 file_content（无 Subject:、From: 等头字段），而 msg 参数被错误地当作额外参数忽略，导致主题等元数据完全丢失。

✅ 正确解法：让 EmailMessage 承担完整消息封装职责，并使用语义明确的 send_message() 方法。

立即学习“Python免费学习笔记（深入）”；

以下是修复后的第二脚本（关键修改已高亮）：

from data import extract_data import smtplib import os from email.message import EmailMessage from dotenv import load_dotenv  _ = load_dotenv()  extract_data()  email_address = os.environ.get("gmail_username") email_password = os.environ.get("gmail_password") sender_email = email_address receiver_email = "recipient@example.com"  # 替换为真实邮箱 password = email_password  # 1. 读取天气报告正文 with open("weather.txt", "r") as my_file:     file_content = my_file.read()  # 2. 构建结构化邮件对象（关键：设置全部必要头部） msg = EmailMessage() msg['Subject'] = 'Daily Weather Report' msg['From'] = sender_email msg['To'] = receiver_email msg.set_content(file_content)  # ✅ 将文本设为纯文本正文（自动处理 MIME 头部）  # 3. 发送完整邮件对象（非字符串） server = smtplib.SMTP('smtp.gmail.com', 587)  # 端口分离更清晰 server.starttls() server.login(sender_email, password) server.send_message(msg)  # ✅ send_message() 接收 EmailMessage 对象，保留所有头部 server.quit()

? 关键要点说明：

• msg.set_content() 不仅设定正文，还会自动添加 Content-Type: text/plain 及必要 MIME 头部，确保 send_message() 能正确序列化整封邮件；
• send_message() 是专为 EmailMessage/MIMEMultipart 等高级消息类设计的方法，它内部调用 as_bytes() 序列化对象，完整保留 Subject、From、To 等字段；
• 避免混用低阶 sendmail()（需手动拼接 RFC 字符串）与高阶 EmailMessage，否则必然导致元数据剥离。

⚠️ 注意事项：

• Gmail SMTP 要求启用「应用专用密码」或开启「两步验证 + 生成 App Password」，普通账户密码将被拒绝；
• 生产环境务必添加异常处理（如 try/except smtplib.SMTPAuthenticationError）并关闭连接（server.quit() 或使用 with 语句）；
• 若需支持 HTML 正文或附件，改用 msg.add_alternative(html_content, subtype=’html’) 或 msg.add_attachment() 即可扩展。

遵循此模式，你的每日天气邮件将稳定携带主题、正确发件人标识，并符合现代邮件协议规范。