当前位置：首页 > 文章列表 > 文章 > python教程 > Python自动发邮件教程步骤详解

Python自动发邮件教程步骤详解

2026-03-01 19:19:50 0浏览收藏

Python自动化发邮件远比想象中简单却功能强大——借助smtplib和email模块，你不仅能轻松发送纯文本、HTML格式邮件，还能灵活添加附件、实现SSL/TLS加密连接，并通过授权码认证保障安全；文章手把手拆解从基础配置、多类型内容构建到SMTP常见错误排查的完整链路，更进一步融入异常分级捕获、结构化日志记录与智能重试机制，助你打造高稳定性、可维护、生产就绪的邮件自动化系统，从此告别重复操作，让通知、报告与提醒真正“一键直达”。

Python代码如何实现自动化邮件发送 Python代码操作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()方法。

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

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>
    <p>你好，</p>
    <p>这是一封<b>HTML格式</b>的自动化测试邮件。</p>
    <p>这是一个链接：<a href="https://www.python.org">Python官网</a></p>
</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', f'attachment; 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配置错误：

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)

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

好了，本文到此结束，带大家了解了《Python自动发邮件教程步骤详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！

Python代码