Python SMTP自动发送邮件完整实现与配置指南
本文详解如何利用Python的smtplib库实现自动发送邮件功能。内容涵盖SendEmailManager类的构建、QQ邮箱SMTP服务器配置(端口465)、客户端授权码获取方法,以及纯文本、HTML和附件邮件的完整发送流程。通过具体代码示例,展示如何初始化参数、登录服务器、构建邮件对象并执行发送操作,适用于需要自动化邮件通知的开发场景。
Python SMTP自动发送邮件基础
近期在项目开发中,遇到了向指定邮箱自动发送信息的需求。为了高效完成这一任务,我们需要掌握利用Python实现自动发送邮件的技术方案。下文将详细解析具体的实现步骤与核心代码逻辑。
Python SMTP发送邮件基础
SMTP(Simple Mail Transfer Protocol,简单邮件传输协议)是互联网上用于发送邮件的标准协议。Python标准库中的smtplib模块对SMTP协议进行了封装,提供了便捷的接口支持。利用该库,开发者可以轻松实现发送纯文本邮件、HTML格式邮件以及包含附件的复杂邮件功能。
SendEmailManager类结构设计
为了实现模块化和可维护性,我们采用面向对象编程思想,构建一个名为SendEmailManager的类来管理邮件发送逻辑。该类的大致结构如下所示:
class SendEmailManager(object):
def __init__(self, **kwargs):
# 初始化参数
...
def _get_conf(self, key):
# 获取配置参数
...
def _init_conf(self):
# 初始化配置参数
...
def _login_email(self):
# 登录邮箱服务器
...
def _make_mail_msg(self):
# 构建文本邮件对象
...
def do_send_mail(self):
# 邮件发送
...
def __init__(self, **kwargs)
初始化与配置获取
这是类的初始化方法,用于设置对象属性并赋予初始值。参数**kwargs允许传入一个可变的关键字参数字典作为函数实参。在此类中,主要利用该机制对SMTP服务器地址(以QQ邮箱为例)、发件人代理邮箱、客户端授权密码以及其他可变参数进行初始化配置。具体实现代码如下:
# SMTP服务器,这里使用qq邮箱,其他邮箱自行百度
EMAIL_HOST = 'smtp.qq.com'
# 发送邮件的代理邮箱
EMAIL_HOST_USER = 'xxxx@xxxx.com'
# 在邮箱中设置的客户端授权密码, 注意这里不是邮箱密码,如何获取邮箱授权码,请看本文最后教程
EMAIL_HOST_PASSWORD = 'xxxxxxxxxxxxx'
def __init__(self, **kwargs):
# 初始化参数
self.email_host = EMAIL_HOST
self.email_host_user = EMAIL_HOST_USER
self.email_host_pass = EMAIL_HOST_PASSWORD
self.kwargs = kwargs
def _get_conf(self, key)
该辅助函数的主要功能是根据传入的key键值,从可变参数字典self.kwargs中读取对应的配置值,供类中其他方法调用,确保配置信息的统一获取。
def _get_conf(self, key):
# 获取配置参数
value = self.kwargs.get(key)
if key != "attach_file_list" and (value is None or value == ''):
raise Exception("configuration parameter '%s' cannot be empty" % key)
return value
def _init_conf(self)
此函数负责调用_get_conf方法,将读取到的配置参数进行初始化赋值,以便后续发送邮件的其他函数能够直接调用这些已配置好的参数。
def _init_conf(self):
# 初始化配置参数
print(self._get_conf('receives'))
self.receives = self._get_conf('receives')
self.msg_subject = self._get_conf('msg_subject')
self.msg_content = self._get_conf('msg_content')
self.msg_from = self._get_conf('msg_from')
# attachment
self.attach_file_list = self._get_conf('attach_file_list')
服务器登录与邮件构建
def _login_email(self)
该函数用于登录邮件服务器。示例中连接的是QQ邮箱服务器,使用端口号465。若使用其他邮箱服务商,请查询其对应的SMTP端口号。具体登录代码如下:
def _login_email(self):
# 登录邮箱服务器
try:
server = smtplib.SMTP_SSL(self.email_host, port=465)
# set_debuglevel(1)可以打印出和SMTP服务器交互的所有信息
server.set_debuglevel(1)
# 登录邮箱
server.login(self.email_host_user, self.email_host_pass)
return server
except Exception as e:
print("mail login exception:", e)
raise e
def _make_mail_msg(self)
此函数的功能是构建一个邮件实例对象,用于处理邮件的具体内容。一封标准的邮件通常包含收发件人信息、邮件主题和正文,部分邮件还可能包含附件。具体的设置逻辑参见以下代码:
def _make_mail_msg(self):
# 构建邮件对象
msg = MIMEMultipart()
msg.attach(MIMEText(self.msg_content, 'plain', 'utf-8'))
# 邮件主题
msg['Subject'] = Header(self.msg_subject, "utf-8")
# 发件人邮箱信息
msg['From'] = "<%s>" % self.msg_from
# msg['From'] = Header(self.msg_from + "<%s>" % self.email_host_user, "utf-8")
msg['To'] = ",".join(self.receives)
print("---", self.attach_file_list)
if self.attach_file_list:
for i, att in enumerate(self.attach_file_list):
# 构造附件,传送当前目录下的文件
if not att:
break
att_i = MIMEText(open(att, 'rb').read(), 'base64', 'utf-8')
att_i["Content-Type"] = 'application/octet-stream'
# 这里的filename可以任意写,写什么名字,邮件中显示什么名字
att_i["Content-Disposition"] = 'attachment; filename="%s"' % att
msg.attach(att_i)
return msg
邮件发送执行流程
def do_send_mail(self)
这是邮件发送的主执行函数,它将前述的初始化、登录、构建邮件对象等步骤串联起来,直接执行发送操作。具体代码如下:
def do_send_mail(self):
# 邮件发送
try:
self._init_conf()
server = self._login_email()
msg = self._make_mail_msg()
server.sendmail(self.email_host_user, self.receives, msg.as_string())
server.close()
print("发送成功!")
except Exception as e:
print("邮件发送异常", e)
配置测试与授权码获取
以下是配置参数及测试能否正常发送邮件的代码示例:
if __name__ == "__main__":
mail_conf = {
'msg_from': 'xxxx@qq.com', # 邮件发送者的地址
'receives': ['xxxx@qq.com', 'xxxxxxxx@xxxx.com', ], # 邮件接收者的地址,这是个list,因为邮件的接收者可能不止一个
'msg_subject': 'Python 自动发送邮件测试!!', # 邮件的主题
'msg_content': '人生苦短,我用python!!!', # 邮件的内容
'attach_file_list': {"test_file1.py": "test.py", "test_file2.pem": "./public.pem"}, # 为附件文件路径列表,也是个list,也可没有这项
}
manager = SendEmailManager(**mail_conf)
manager.do_send_mail()

测试结果显示发送成功,且添加附件的功能同样可以正常运行。
前文提到的获取客户端邮箱授权码的操作,具体教程如下(以QQ邮箱为例):

至此,目标功能已全部实现。
以上就是本文的全部内容,希望能为读者的学习带来帮助,也欢迎大家继续支持本站获取更多技术资源。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













