
使用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() 即可扩展。
遵循此模式,你的每日天气邮件将稳定携带主题、正确发件人标识,并符合现代邮件协议规范。










