Python代码如何实现自动化邮件发送 Python代码操作SMTP服务的详细步骤

游戏科技网2026年09月14日 22:24云服务器30

描述：Python可通过smtplib和email模块实现邮件自动化，支持纯文本、HTML及附件发送，需正确配置SMTP服务器、使用授权码认证，并通过异常处理、日志记录与重试机制提升系统健壮性。说起自动化，邮件发送绝对是日常工作中一个高频场景。用Python实现这个功能，其实比想象中要简单，核心在于理解S…

Python可通过smtplib和email模块实现邮件自动化，支持纯文本、HTML及附件发送，需正确配置SMTP服务器、使用授权码认证，并通过异常处理、日志记录与重试机制提升系统健壮性。

说起自动化，邮件发送绝对是日常工作中一个高频场景。用Python实现这个功能，其实比想象中要简单，核心在于理解SMTP协议，并巧妙运用Python的smtplib和email模块来构建和发送邮件。它能让我们摆脱重复的手动操作，无论是发送报告、通知还是提醒，都能高效完成。

Python代码操作SMTP服务的详细步骤

刚开始接触的时候，我总觉得这套流程会很复杂，涉及到各种网络协议的细节。但实践下来，Python的封装做得相当到位，我们更多是关注参数配置和邮件内容的组织。以下是一个基本的发送邮件流程：

导入必要的模块：smtplib用于SMTP通信，email.mime.text（或email.mime.multipart、email.mime.base）用于构建邮件内容。
设置邮件信息：包括发件人邮箱、收件人邮箱、主题和邮件正文。
创建邮件对象：使用MIMEText（纯文本邮件）或MIMEMultipart（包含附件、HTML等复杂邮件）。
连接SMTP服务器：通常使用smtplib.SMTP_SSL（推荐，加密连接）或smtplib.SMTP（非加密，可配合starttls()升级为加密）。
登录SMTP服务器：使用发件人邮箱的账号和授权码（或密码）进行认证。
发送邮件：调用sendmail()方法。
关闭连接：调用quit()方法。

这是一个简单的纯文本邮件发送示例：

立即学习“Python免费学习笔记（深入）”；

import smtplib

from email.mime.text import MIMEText

from email.header import Header

# 邮件配置

sender_email = your_email@example.com # 替换为你的发件邮箱

receiver_email = recipient@example.com # 替换为收件人邮箱

smtp_server = smtp.example.com # 替换为你的SMTP服务器地址 (如：smtp.gmail.com)

smtp_port = 465 # SSL端口通常是465，TLS/STARTTLS端口通常是587

smtp_username = your_email@example.com # 替换为你的邮箱账号

smtp_password = your_app_password # 替换为你的邮箱授权码或密码

# 邮件内容

subject = Python自动化邮件测试

body = 你好，这是一封通过Python自动化发送的测试邮件。

# 构建邮件

msg = MIMEText(body, plain, utf-8)

msg[From] = Header("发件人名称", utf-8)

msg[To] = Header("收件人名称", utf-8)

msg[Subject] = Header(subject, utf-8)

try:

# 连接到SMTP服务器 (使用SSL加密连接)

server = smtplib.SMTP_SSL(smtp_server, smtp_port)

# server.set_debuglevel(1) # 开启调试模式，可以看到详细的SMTP交互日志

# 登录邮箱

server.login(smtp_username, smtp_password)

# 发送邮件

server.sendmail(sender_email, receiver_email, msg.as_string())

print("邮件发送成功！")

except smtplib.SMTPException as e:

print(f"邮件发送失败: {e}")

except Exception as e:

print(f"发生其他错误: {e}")

finally:

if server in locals() and server:

server.quit()

请注意，对于Gmail、Outlook等主流邮箱服务，为了安全，通常需要生成一个“授权码”或“应用专用密码”来代替你的邮箱登录密码，否则可能会遇到认证失败的问题。

Python发送邮件时如何处理附件和HTML内容？

这块功能其实非常实用，毕竟纯文本邮件在很多场景下已经不够用了。尤其是附件，无论是报告、图片还是其他文件，都是邮件自动化不可或缺的一部分。处理附件和HTML内容，我们需要用到email.mime.multipart和email.mime.base模块。

MIMEMultipart对象可以看作是邮件的容器，我们可以往里面添加不同类型的子部分（比如文本、HTML、附件）。

发送HTML内容：将MIMEText的第二个参数从plain改为html即可。

from email.mime.text import MIMEText

html_body = """

<html>

<head></head>

<body>

你好，

这是一封HTML格式的自动化测试邮件。

这是一个链接：<a href="https://www.python.org">Python官网</a>

</body>

</html>

"""

msg_html = MIMEText(html_body, html, utf-8)

# 然后像之前一样设置From, To, Subject，并通过SMTP发送

发送带附件的邮件：这需要MIMEMultipart来组合邮件的不同部分，并使用MIMEBase（或更具体的MIMEApplication, MIMEImage等）来处理附件。

import smtplib

from email.mime.text import MIMEText

from email.mime.multipart import MIMEMultipart

from email.mime.base import MIMEBase

from email import encoders

from email.header import Header

import os

sender_email = your_email@example.com

receiver_email = recipient@example.com

smtp_server = smtp.example.com

smtp_port = 465

smtp_username = your_email@example.com

smtp_password = your_app_password

subject = Python自动化邮件带附件

body = 请查收附件中的文件。

attachment_path = example.txt # 假设有一个名为 example.txt 的文件在当前目录

# 创建MIMEMultipart对象

msg = MIMEMultipart()

msg[From] = Header("发件人名称", utf-8)

msg[To] = Header("收件人名称", utf-8)

msg[Subject] = Header(subject, utf-8)

# 添加邮件正文

msg.attach(MIMEText(body, plain, utf-8))

# 添加附件

try:

with open(attachment_path, rb) as f:

part = MIMEBase(application, octet-stream)

part.set_payload(f.read())

encoders.encode_base64(part)

part.add_header(Content-Disposition, fattachment; filename="{os.path.basename(attachment_path)}")

msg.attach(part)

except FileNotFoundError:

print(f"附件文件未找到: {attachment_path}")

except Exception as e:

print(f"处理附件时发生错误: {e}")

# 接下来的SMTP连接和发送代码与之前相同

try:

server = smtplib.SMTP_SSL(smtp_server, smtp_port)

server.login(smtp_username, smtp_password)

server.sendmail(sender_email, receiver_email, msg.as_string())

print("带附件邮件发送成功！")

except smtplib.SMTPException as e:

print(f"邮件发送失败: {e}")

except Exception as e:

print(f"发生其他错误: {e}")

finally:

if server in locals() and server:

server.quit()

这里，MIMEBase(application, octet-stream)表示这是一个通用的二进制文件附件。encoders.encode_base64(part)对附件内容进行Base64编码，这是邮件传输的常见做法。Content-Disposition头则指定了附件的文件名。

Python自动化邮件发送中常见的SMTP配置错误与安全考量有哪些？

我记得有一次，邮件死活发不出去，排查了半天，才发现是Gmail的安全设置里，“允许不够安全的应用”被关闭了。这种小细节，真是能让人抓狂。在自动化邮件发送过程中，配置错误和安全问题是开发者经常会遇到的挑战。

常见的SMTP配置错误：

Python代码如何实现自动化邮件发送 Python代码操作SMTP服务的详细步骤

GitHub Token

使用个人访问令牌与GitHub交互，安全、用户可控的访问方式，无需OAuth或完整账户权限。支持克隆、推送、分支、PR、Issue等操作。适用于需要操作GitHub仓库的场景。

下载

SMTP服务器地址或端口错误：不同的邮件服务商有不同的SMTP服务器地址（如smtp.gmail.com，smtp.office365.com）和端口。SSL加密通常是465，STARTTLS通常是587。务必核对正确。
认证失败：
- 用户名或密码不正确：这是最常见的问题。对于Gmail、Outlook等，需要使用“授权码”或“应用专用密码”，而不是你的账户登录密码。
- 邮箱服务商的安全设置：某些邮箱会默认阻止来自“不够安全的应用”的登录尝试。需要手动在邮箱设置中开启此选项（如Gmail的“允许不够安全的应用访问”）。
- 两步验证：如果开启了两步验证，通常也需要生成应用专用密码。
网络或防火墙问题：你的服务器或本地网络可能阻止了对SMTP端口的访问。可以尝试telnet smtp.example.com 465（或587）来测试端口连通性。
发件人邮箱未开启SMTP服务：某些企业邮箱或自定义域名邮箱可能需要管理员手动开启SMTP/POP3服务。
邮件发送频率限制：很多邮件服务商对个人账户的每日邮件发送量有上限，超出限制可能会被暂时封禁。

安全考量：

使用加密连接：始终优先使用SSL/TLS加密连接。
- smtplib.SMTP_SSL(host, port)：直接建立SSL加密连接，通常端口是465。
- smtplib.SMTP(host, port)配合server.starttls()：先建立非加密连接，再升级为TLS加密，通常端口是587。
- 避免在没有加密的情况下发送敏感信息（如登录凭据）。
避免硬编码凭据：将邮箱账号和授权码直接写在代码中是非常不安全的做法。
- 环境变量：推荐将敏感信息存储在环境变量中，代码运行时读取。
- 配置文件：使用.ini、.json或.env等配置文件，但要确保这些文件不会被意外提交到版本控制系统（如Git）。
- 密钥管理服务：在生产环境中，可以考虑使用云服务商提供的密钥管理服务。
授权码或应用专用密码：如前所述，使用这种机制比直接使用主密码更安全，因为它通常可以独立撤销，且权限范围更小。
最小权限原则：确保用于发送邮件的账户只有发送邮件所需的权限，避免赋予不必要的权限。
日志记录：记录邮件发送的成功与失败，但不要在日志中记录敏感的凭据信息。

如何构建一个更健壮的Python邮件发送系统，包含错误处理和日志记录？

实际项目里，我们不可能指望邮件发送总是一帆风顺。网络波动、服务器临时故障，这些都可能导致发送失败。所以，一套完善的错误处理和日志机制，是衡量一个自动化系统是否健壮的关键。它能帮助我们快速定位问题，并在可能的情况下自动恢复。

错误处理（使用try-except）：

Python的smtplib模块定义了多种异常，我们可以针对性地捕获和处理。

smtplib.SMTPConnectError：无法连接到SMTP服务器。
smtplib.SMTPAuthenticationError：登录认证失败（用户名或密码错误）。
smtplib.SMTPServerDisconnected：服务器意外断开连接。
smtplib.SMTPRecipientsRefused：部分或所有收件人被服务器拒绝。
smtplib.SMTPDataError：服务器拒绝邮件数据。
smtplib.SMTPException：所有smtplib异常的基类。

在代码中，我们可以用try...except块来捕获这些异常，并根据异常类型采取不同的应对策略。

import smtplib

# ... (其他导入和配置)

def send_email_robust(sender, receiver, msg, smtp_server, smtp_port, username, password):

try:

server = smtplib.SMTP_SSL(smtp_server, smtp_port, timeout=10) # 设置连接超时

server.login(username, password)

server.sendmail(sender, receiver, msg.as_string())

print(f"邮件成功发送至 {receiver}")

return True

except smtplib.SMTPConnectError as e:

print(f"错误: 无法连接到SMTP服务器。请检查服务器地址、端口和网络连接。详细: {e}")

except smtplib.SMTPAuthenticationError as e:

print(f"错误: SMTP认证失败。请检查用户名和授权码/密码。详细: {e}")

except smtplib.SMTPServerDisconnected as e:

print(f"错误: SMTP服务器意外断开连接。详细: {e}")

except smtplib.SMTPRecipientsRefused as e:

print(f"错误: 收件人被服务器拒绝。详细: {e.recipients}")

except smtplib.SMTPDataError as e:

print(f"错误: 服务器拒绝邮件数据。可能是邮件内容或格式问题。详细: {e}")

except smplib.SMTPException as e:

print(f"发生通用SMTP错误: {e}")

except Exception as e:

print(f"发生未知错误: {e}")

finally:

if server in locals() and server:

server.quit()

return False

# 调用示例

# success = send_email_robust(sender_email, receiver_email, msg, smtp_server, smtp_port, smtp_username, smtp_password)

日志记录（使用logging模块）：

Python的logging模块功能强大且灵活，是记录应用程序事件的标准方式。它比简单的print()语句更适合生产环境。

import logging

import smtplib

# ... (其他导入和配置)

# 配置日志

logging.basicConfig(level=logging.INFO,

format=%(asctime)s - %(levelname)s - %(message)s,

handlers=[

logging.FileHandler("email_automation.log"), # 记录到文件

logging.StreamHandler() # 也输出到控制台

])

def send_email_with_logging(sender, receiver, msg, smtp_server, smtp_port, username, password):

try:

server = smtplib.SMTP_SSL(smtp_server, smtp_port, timeout=10)

server.login(username, password)

server.sendmail(sender, receiver, msg.as_string())

logging.info(f"邮件成功发送至 {receiver}，主题：{msg[Subject]}")

return True

except smtplib.SMTPConnectError as e:

logging.error(f"无法连接到SMTP服务器。收件人: {receiver}。错误: {e}")

except smtplib.SMTPAuthenticationError as e:

logging.error(f"SMTP认证失败。收件人: {receiver}。错误: {e}")

except smtplib.SMTPException as e:

logging.error(f"发生SMTP错误。收件人: {receiver}。错误: {e}", exc_info=True) # exc_info=True 会记录完整的堆栈信息

except Exception as e:

logging.critical(f"发生未知严重错误。收件人: {receiver}。错误: {e}", exc_info=True)

finally:

if server in locals() and server:

server.quit()

return False

# 调用示例

# success = send_email_with_logging(sender_email, receiver_email, msg, smtp_server, smtp_port, smtp_username, smtp_password)

通过logging模块，我们可以控制日志的级别（DEBUG, INFO, WARNING, ERROR, CRITICAL），将日志输出到文件、控制台，甚至通过网络发送。exc_info=True在记录错误时会包含完整的堆栈信息，这对于调试至关重要。

重试机制：

对于瞬时错误（如网络波动导致的连接失败），简单的重试机制可以显著提高系统的健壮性。

import time

# ... (其他导入和配置，以及 send_email_with_logging 函数)

MAX_RETRIES = 3

RETRY_DELAY_SECONDS = 5

def send_email_with_retries(sender, receiver, msg, smtp_server, smtp_port, username, password):

for attempt in range(MAX_RETRIES):

logging.info(f"尝试发送邮件至 {receiver} (尝试 {attempt + 1}/{MAX_RETRIES})")

if send_email_with_logging(sender, receiver, msg, smtp_server, smtp_port, username, password):

return True

elif attempt < MAX_RETRIES - 1:

logging.warning(f"邮件发送失败，将在 {RETRY_DELAY_SECONDS} 秒后重试...")

time.sleep(RETRY_DELAY_SECONDS)

logging.error(f"邮件发送至 {receiver} 失败，已达最大重试次数。")

return False

# 调用示例

# success = send_email_with_retries(sender_email, receiver_email, msg, smtp_server, smtp_port, smtp_username, smtp_password)

这个重试逻辑很简单，在失败后等待一段时间再尝试。实际应用中，重试策略可以更复杂，比如指数退避（每次重试的等待时间逐渐增加）。结合这些机制，我们的自动化邮件发送系统就能应对各种突发状况，变得更加可靠。

本文链接：https://www.orefo.cn/yfwq/68907.html

返回列表

上一篇：星海幸存者最新版

下一篇：FontCreator Pro 15002941 字体编辑设计

大家都在搜：

Python代码如何实现自动化邮件发送 Python代码操作SMTP服务的详细步骤

“Python代码如何实现自动化邮件发送 Python代码操作SMTP服务的详细步骤” 的相关文章

5元云服务器：入门级新手首选

6元服务器租用，高性价比VPS主机推荐

2021年云服务器优惠套餐推荐

云服务器市场增长

1元买走一台云服务器，这种天上掉馅饼的事存在吗？

云服务器10元月：经济型服务价格新记录

游戏科技网站

www.orefo.cn 的站点信息备案号：渝ICP备2025076537号-22