Python SMTP自动发送邮件完整实现与配置指南

半杯拿铁
半杯拿铁
发布时间:2026-10-13| 4人浏览过
原创

本文详解如何利用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邮箱为例):

至此,目标功能已全部实现。

以上就是本文的全部内容,希望能为读者的学习带来帮助,也欢迎大家继续支持本站获取更多技术资源。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。