当前位置： 首页 > news >正文

【Python】基于Python自动化邮件发送系统：从配置到实现的完整指南

news 2025/8/8 6:57:43

一、前言：

在现代软件开发和自动化流程中，邮件通知是一个常见且实用的功能。无论是用于发送报告、告警信息还是用户提醒，通过 Python 实现自动化的邮件发送功能都能极大提升工作效率。本文将基于你提供的两个文件（`.env` 配置文件与 Python 脚本），详细介绍如何构建一个支持单发和群发、可配置 SMTP 的邮件发送系统。

二、项目概述

我们将使用以下技术栈来完成这个任务：

  • Python：核心编程语言
  • smtplib：Python 内置库，用于连接 SMTP 服务器
  • email.mime：处理邮件内容（文本、HTML、附件）
  • python-dotenv：读取 `.env` 文件中的环境变量
  • os：获取环境变量
  • json：处理结构化数据（如 JSON 格式的邮件正文）

三、配置文件 `.env` 解析

你的 `.env` 文件如下所示：

# Gmail 配置
EMAIL=123477787@qq.com  ## 你的邮箱地址
EMAIL_PASSWORD=vfoae#####   ## 你的授权码# 其他配置项
SMTP_SERVER=smtp.qq.com
SMTP_PORT=587

该文件定义了发送邮件所需的必要参数：

  • EMAIL：发件人邮箱地址
  • EMAIL_PASSWORD：授权码（不是登录密码！QQ 邮箱需要开启 POP3/SMTP 并获取授权码）
  • SMTP_SERVER 和 SMTP_PORT：指定 SMTP 服务器地址及端口

⚠️ 注意：QQ 邮箱等部分邮箱不支持直接使用登录密码，需启用“POP3/SMTP服务”并获取专用授权码。

四、代码结构解析

1. 导入模块

import json
import os
from dotenv import load_dotenv
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders

这些模块分别负责加载环境变量、连接 SMTP 服务器、构造邮件内容以及编码附件。

2. 加载环境变量

load_dotenv()
EMAIL = os.getenv('EMAIL')
PASSWORD = os.getenv('EMAIL_PASSWORD')
SMTP_SERVER = os.getenv('SMTP_SERVER')
SMTP_PORT = int(os.getenv('SMTP_PORT'))

通过 `python-dotenv` 模块读取 `.env` 中的配置信息，并将其赋值给全局变量。

3. EmailSender 类设计

这是整个系统的核心类，封装了连接、发送、断开 SMTP 的逻辑。

初始化方法：

def __init__(self, smtp_server, smtp_port, email, password):self.smtp_server = smtp_serverself.smtp_port = smtp_portself.email = emailself.password = password

连接服务器：

def connect(self):try:self.server = smtplib.SMTP(self.smtp_server, self.smtp_port)self.server.starttls()self.server.login(self.email, self.password)return Trueexcept Exception as e:print(f"连接失败：{e}")return False

发送邮件（支持纯文本、HTML、附件）：

def send_email(self, to_email, subject, body, html_body=None, attachments=None):...

群发邮件功能：

def send_bulk_email(self, to_emails, subject, body, html_body=None, attachments=None):...

断开连接：

def disconnect(self):if hasattr(self, 'server'):self.server.quit()

4. 主函数调用逻辑

def checker_send_email(recipient_list, title_text, ret_text):sender = EmailSender(SMTP_SERVER, SMTP_PORT, EMAIL, PASSWORD)if sender.connect():data = json.dumps(ret_text, ensure_ascii=False, indent=2) if isinstance(ret_text, dict) else ret_textsuccess = sender.send_bulk_email(to_emails=recipient_list,subject=title_text,body=data,)if success:print("邮件发送成功！")sender.disconnect()return

此函数作为对外接口，接受收件人列表、主题、内容，然后进行群发操作。

5. 测试入口

if __name__ == '__main__':recipients = ['402914287@qq.com']title = '群发邮件测试'ret = "这是一封测试邮件"checker_send_email(recipients, title, ret)

运行脚本时，会向指定邮箱发送一封测试邮件。

五、完整代码：

.env文件内容：

# Gmail 配置
EMAIL=123477787@qq.com  ## 你的邮箱地址
EMAIL_PASSWORD=vfoae#####   ## 你的授权码# 其他配置项
SMTP_SERVER=smtp.qq.com
SMTP_PORT=587

send_mail.python文件内容：

import json
import os
from dotenv import load_dotenv
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encodersload_dotenv()
EMAIL = os.getenv('EMAIL')
PASSWORD = os.getenv('EMAIL_PASSWORD')
SMTP_SERVER = os.getenv('SMTP_SERVER')
SMTP_PORT = os.getenv('SMTP_PORT')# # 常用邮箱SMTP设置
# SMTP_SETTINGS = {
#     'gmail': {
#         'server': 'smtp.gmail.com',
#         'port': 587
#     },
#     'outlook': {
#         'server': 'smtp-mail.outlook.com',
#         'port': 587
#     },
#     'qq': {
#         'server': 'smtp.qq.com',
#         'port': 587
#     },
#     '163': {
#         'server': 'smtp.163.com',
#         'port': 25
#     },
#     'sina': {
#         'server': 'smtp.sina.com',
#         'port': 25
#     }
# }# def get_smtp_config(provider):
#     """获取SMTP配置"""
#     return SMTP_SETTINGS.get(provider, SMTP_SETTINGS['gmail'])class EmailSender:def __init__(self, smtp_server, smtp_port, email, password):self.smtp_server = smtp_serverself.smtp_port = smtp_portself.email = emailself.password = passworddef connect(self):"""连接SMTP服务器"""try:self.server = smtplib.SMTP(self.smtp_server, self.smtp_port)self.server.starttls()self.server.login(self.email, self.password)return Trueexcept Exception as e:print(f"连接失败：{e}")return Falsedef send_email(self, to_email, subject, body, html_body=None, attachments=None):"""发送邮件"""try:msg = MIMEMultipart('alternative')msg['From'] = self.emailmsg['To'] = to_emailmsg['Subject'] = subject# 添加文本内容msg.attach(MIMEText(body, 'plain', 'utf-8'))# 添加HTML内容（如果提供）if html_body:msg.attach(MIMEText(html_body, 'html', 'utf-8'))# 添加附件（如果提供）if attachments:for file_path in attachments:if os.path.exists(file_path):with open(file_path, "rb") as attachment:part = MIMEBase('application', 'octet-stream')part.set_payload(attachment.read())encoders.encode_base64(part)part.add_header('Content-Disposition',f'attachment; filename= {os.path.basename(file_path)}')msg.attach(part)# 发送邮件self.server.sendmail(self.email, to_email, msg.as_string())return Trueexcept Exception as e:print(f"发送失败：{e}")return Falsedef send_bulk_email(self, to_emails, subject, body, html_body=None, attachments=None):"""群发邮件:param to_emails: 收件人邮箱列表:param subject: 邮件主题:param body: 邮件正文:param html_body: HTML格式正文:param attachments: 附件列表"""if not self.server:print("请先连接到SMTP服务器")return Falsesuccess_count = 0for email in to_emails:if self.send_email(email, subject, body, html_body, attachments):success_count += 1print(f"群发完成：成功 {success_count}/{len(to_emails)}")return success_count == len(to_emails)def disconnect(self):"""断开连接"""if hasattr(self, 'server'):self.server.quit()def checker_send_email(recipient_list, title_text, ret_text):"""发送邮件"""sender = EmailSender(SMTP_SERVER, SMTP_PORT, EMAIL, PASSWORD)if sender.connect():# 单发邮件# success = sender.send_email(#     '3909878531@qq.com',#     '测试邮件',#     '这是一封测试邮件',#     # html_body='<h1>测试邮件</h1><p>这是一封HTML邮件</p>',#     # attachments=['file1.pdf', 'file2.docx']# )# 群发邮件data = json.dumps(ret_text, ensure_ascii=False, indent=2) if isinstance(ret_text, dict) else ret_textsuccess = sender.send_bulk_email(to_emails=recipient_list,subject=title_text,body=data,# html_body='<h1>测试邮件</h1><p>这是一封HTML邮件</p>',)if success:print("邮件发送成功！")sender.disconnect()returnif __name__ == '__main__':recipients = ['23398877797@qq.com']title = '群发邮件测试'ret = "这是一封测试邮件"checker_send_email(recipients, title, ret)

六、总结

通过合理使用 `.env` 配置文件、`smtplib` 及 `email` 模块，我们可以轻松实现单发、群发、带附件的邮件功能。这种自动化工具在实际工作中具有很高的实用价值，特别是在定时任务、监控报警、数据分析等场景中。

📌 **提示**：在部署到生产环境前，请务必确认邮箱账号权限设置正确，并对敏感信息（如密码）做好安全保护措施。

http://www.dtcms.com/a/319428.html

相关文章：

  • 【YOLOv8改进 - C2f融合】C2f融合SFS-Conv（空间 - 频率选择卷积）提升特征多样性，同时减少参数和计算量
  • 如何在 VS Code 中进行 `cherry-pick`
  • 使用Python验证常见的50个正则表达式
  • react接口防抖处理
  • [网格图DP]3363. 最多可收集的水果数目
  • 视频二维码如何助力博物馆打造智慧讲解体验
  • 数据库事务总结
  • 升级g++编译器
  • RK3568项目(十二)--linux驱动开发之基础通讯接口(上)
  • 时序数据库的功能与应用价值
  • RPC 解析
  • Renesas Electronics RZ/V2N 评估套件
  • 从密钥生成到功能限制：Electron 中 secure-electron-license-keys 的完整集成方案
  • Spring Cloud系列—LoadBalance负载均衡
  • 5分钟了解OpenCV
  • 用 Enigma Virtual Box 把 Qt 程序压成单文件 EXE——从编译、收集依赖到一键封包
  • 大数据spark、hasdoop 深度学习、机器学习算法的音乐平台用户情感分析系统设计与实现
  • 多线程 future.get()的线程阻塞是什么意思？
  • Spark Memory 内存设计的核心组件
  • 2025年主流开源音视频播放项目深度解析
  • 数据结构——B-树、B+树、B*树
  • flutter-使用AnimatedDefaultTextStyle实现文本动画
  • 状压DP-子集枚举技巧
  • MySQL UNION 操作符详细说明
  • 机器视觉系统工业相机的成像原理及如何选型
  • 数据结构-哈希表（散列表）
  • 进程控制:进程的创建、终止、阻塞、唤醒、切换等生命周期管理操作
  • 基于深度学习的调制信号分类识别算法的研究生学习之旅
  • C语言sprintf、strcmp、strcpy、strcat函数详解：字符串操作的核心工具
  • Modbus转Profinet网关与西门子PLC的互联配置案例：用于永宏品牌变频器的控制实现