
使用email.message.EmailMessage构建邮件时,若仅设置msg['Subject']但未调用send_message()而是误用sendmail(),会导致主题丢失——根本原因是sendmail()仅发送原始字符串内容,不解析邮件头;而send_message()才真正序列化并传输完整的MIME消息对象。
使用`email.message.emailmessage`构建邮件时,若仅设置`msg['subject']`但未调用`send_message()`而是误用`sendmail()`,会导致主题丢失——根本原因是`sendmail()`仅发送原始字符串内容,不解析邮件头;而`send_message()`才真正序列化并传输完整的mime消息对象。
在Python中通过smtplib发送带格式(如主题、发件人、收件人)的电子邮件时,一个常见却极易被忽视的错误是:混淆了sendmail()与send_message()两个方法的语义与使用前提。问题代码中虽然正确创建了EmailMessage对象并设置了msg['Subject'],但在发送阶段却调用了server.sendmail(sender_email, receiver_email, file_content, msg)——这不仅参数顺序错误(sendmail()不接受msg作为第四个参数),更关键的是:sendmail()期望接收已完全序列化的RFC 5322格式字符串(含所有头部),而它不会自动从EmailMessage对象中提取或渲染头部信息。
相比之下,send_message()是专为EmailMessage(或MIMEMultipart等MIME对象)设计的高层接口:它会自动调用msg.as_bytes()完成完整邮件的序列化(包括Subject、From、To、Date及正文),确保所有元数据准确嵌入最终传输的数据流中。
✅ 正确做法是:将所有邮件元数据(主题、发件人、收件人)统一设在EmailMessage实例上,并使用send_message()发送该实例。以下是修正后的第二脚本(关键修改已高亮):
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" # 注意:请替换为真实邮箱,勿保留HTML转义邮箱链接
# 读取天气报告文本
with open("weather.txt", "r", encoding="utf-8") as my_file:
file_content = my_file.read()
# ✅ 步骤1:构建完整邮件对象(设置全部头部 + 内容)
msg = EmailMessage()
msg["Subject"] = "Daily Weather Report"
msg["From"] = sender_email
msg["To"] = receiver_email
msg.set_content(file_content) # 纯文本内容(自动设置Content-Type: text/plain)
# ✅ 步骤2:使用 send_message() 发送完整消息对象
server = smtplib.SMTP("smtp.gmail.com", 587) # 端口作为独立参数更清晰
server.starttls()
server.login(sender_email, email_password)
server.send_message(msg) # 关键!传入 EmailMessage 实例
server.quit()⚠️ 重要注意事项:
立即学习“Python免费学习笔记(深入)”;
- 不要混用 sendmail() 和 EmailMessage:sendmail() 的签名是 sendmail(from_addr, to_addrs, msg),其中 msg 必须是已序列化的字节串或字符串(例如 msg.as_string()),而非EmailMessage对象本身。强行传入会导致静默失败或头部丢失。
- 显式设置 From/To 头部:Gmail等现代SMTP服务强制校验发件人一致性,仅靠sendmail()参数无法替代邮件头中的From/To字段。
- 编码安全:读取weather.txt时建议指定encoding="utf-8",避免特殊字符(如中文、度符号°)解码异常。
- 环境变量安全:确保.env文件未提交至版本控制,并使用强密码或应用专用密码(App Password)替代Gmail账户密码。
? 进阶提示:若需支持HTML格式邮件或附件,可改用msg.add_alternative(html_content, subtype='html')添加多部分内容,或通过msg.add_attachment()嵌入文件——这些功能均依赖send_message()的完整MIME处理能力。
遵循以上规范,即可彻底解决“Missing email subject”问题,确保邮件标题、发件人、正文等所有要素准确送达收件方。










