Python利用SMTP发送邮件的常见问题与解决方案详解

2025-04-21 08:12:25 作者：码农阿豪@新空间

在自动化办公和系统开发中,邮件发送功能是常见的需求,本文将从实际案例出发,分析常见的SMTP错误,并提供完整的解决方案,希望对大家有一定的帮助

引言

在自动化办公和系统开发中，邮件发送功能是常见的需求。无论是发送通知、报告，还是传输文件，Python的smtplib和email库提供了便捷的实现方式。然而，在实际开发中，开发者常会遇到各种SMTP错误，如(-1, b'\x00\x00\x00')、AttributeError('characters_written')等，这些问题往往让人束手无策。

本文将从实际案例出发，分析常见的SMTP错误，并提供完整的解决方案，帮助开发者快速定位和解决问题。同时，我们还会优化代码，使其更健壮、更易于维护。

1. 问题背景

在Python中，使用smtplib发送邮件时，通常会遇到两类问题：

连接与认证问题（如授权码错误、SMTP服务器拒绝连接）
数据编码与协议问题（如SSL/TLS握手失败、附件编码错误）

以下是一个典型的邮件发送代码，它可能会触发上述错误：

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.application import MIMEApplication
import os
import logging

logger = logging.getLogger(__name__)

def send_email_with_attachment(filepath, receiver_email):
    sender_email = "your_email@qq.com"
    password = "your_authorization_code"  # QQ邮箱授权码
    smtp_server = "smtp.qq.com"
    smtp_port = 465  # QQ邮箱SSL端口

    msg = MIMEMultipart()
    msg['From'] = sender_email
    msg['To'] = receiver_email
    msg['Subject'] = "文件处理结果通知"

    # 邮件正文
    msg.attach(MIMEText("请查收附件", 'plain'))

    # 添加附件
    try:
        with open(filepath, "rb") as f:
            part = MIMEApplication(f.read(), Name=os.path.basename(filepath))
            part['Content-Disposition'] = f'attachment; filename="{os.path.basename(filepath)}"'
            msg.attach(part)
    except FileNotFoundError:
        logger.error("附件文件不存在")
        return False

    # 发送邮件
    try:
        with smtplib.SMTP_SSL(smtp_server, smtp_port) as server:
            server.login(sender_email, password)
            server.sendmail(sender_email, receiver_email, msg.as_string())
        return True
    except Exception as e:
        logger.error(f"发送邮件失败: {e}", exc_info=True)
        return False

运行此代码时，可能会遇到以下错误：

2. 常见错误及解决方案

错误1：SMTPResponseException: (-1, b'\x00\x00\x00')

错误原因

授权码错误或已过期。
SMTP服务器（如QQ邮箱）检测到异常登录，拒绝连接。
网络或防火墙拦截了SMTP请求。

解决方案

1.检查授权码

登录QQ邮箱 → 设置 → 账户 → 生成新的授权码，并替换代码中的password。

2.更换SMTP端口（推荐使用587+TLS）

QQ邮箱支持465（SSL）和587（TLS），后者更稳定：

smtp_port = 587  # 改用TLS端口
with smtplib.SMTP(smtp_server, smtp_port) as server:
    server.starttls()  # 启用TLS加密
    server.login(sender_email, password)

3.检查网络环境

关闭防火墙或切换网络（如使用手机热点测试）。

错误2：AttributeError('characters_written')

错误原因

Python 3.10+ 与 SMTP_SSL 的兼容性问题。
SSL/TLS握手失败，可能是由于OpenSSL版本不匹配。

解决方案

1.改用starttls()（推荐）

避免使用SMTP_SSL，改用SMTP + starttls()：

with smtplib.SMTP(smtp_server, 587) as server:
    server.starttls()  # 显式启用TLS
    server.login(sender_email, password)

2.降级Python或升级依赖库

如果仍报错，尝试降级到Python 3.9，或更新pyopenssl：

pip install --upgrade pyopenssl

3. 优化后的邮件发送代码

结合上述解决方案，优化后的代码如下：

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.application import MIMEApplication
import os
import logging
import base64

logger = logging.getLogger(__name__)

def send_email_with_attachment(filepath, receiver_email):
    """发送带附件的邮件（支持QQ邮箱）"""
    sender_email = "your_email@qq.com"
    password = "your_authorization_code"  # 替换为最新授权码
    smtp_server = "smtp.qq.com"
    smtp_port = 587  # 使用TLS端口

    # 检查附件是否存在
    if not os.path.exists(filepath):
        logger.error(f"附件文件不存在: {filepath}")
        return False

    # 创建邮件内容
    msg = MIMEMultipart()
    msg['From'] = sender_email
    msg['To'] = receiver_email
    msg['Subject'] = "文件处理结果通知"
    msg.attach(MIMEText("请查收附件", 'plain'))

    # 添加附件
    try:
        with open(filepath, "rb") as f:
            part = MIMEApplication(f.read(), Name=os.path.basename(filepath))
            part['Content-Disposition'] = f'attachment; filename="{os.path.basename(filepath)}"'
            msg.attach(part)
    except Exception as e:
        logger.error(f"附件处理失败: {e}")
        return False

    # 发送邮件（使用TLS）
    try:
        with smtplib.SMTP(smtp_server, smtp_port) as server:
            server.starttls()  # 启用TLS加密
            server.login(sender_email, password)
            server.sendmail(sender_email, receiver_email, msg.as_string())
        logger.info("邮件发送成功")
        return True
    except smtplib.SMTPException as e:
        logger.error(f"SMTP错误: {e}")
    except Exception as e:
        logger.error(f"未知错误: {e}", exc_info=True)
    return False

优化点

1.更健壮的异常处理

区分SMTPException和其他异常，便于排查问题。

2.附件预检查

发送前验证附件是否存在。

3.日志记录

使用logging记录详细错误信息。

4. SMTP调试技巧

手动测试SMTP连接

使用openssl命令行工具测试SMTP服务是否可用：

openssl s_client -connect smtp.qq.com:587 -starttls smtp -crlf

输入以下命令（替换为你的邮箱和授权码）：

EHLO test
AUTH LOGIN
<base64编码的邮箱> # 示例：echo -n "your_email@qq.com" | base64
<base64编码的授权码>
QUIT

如果返回235 Authentication successful，说明SMTP配置正确。

检查防火墙

在Windows上，运行以下命令放行SMTP端口：

netsh advfirewall firewall add rule name="SMTP" dir=in action=allow protocol=TCP localport=587

5. 总结与最佳实践

常见问题总结

错误	原因	解决方案
`(-1, b'\x00\x00\x00')`	授权码错误/SMTP拒绝	更新授权码，改用`starttls()`
`AttributeError('characters_written')`	Python 3.10+兼容性问题	降级Python或改用`SMTP` + `starttls()`
`SSL: WRONG_VERSION_NUMBER`	SSL/TLS配置错误	使用`starttls()` + 端口587

最佳实践

使用TLS（端口587）代替SSL（端口465），兼容性更好。
定期更新授权码，避免因过期导致发送失败。
添加日志记录，便于排查问题。
手动测试SMTP连接，确保服务器可用。

通过本文的分析和优化，你应该能够解决大多数Python邮件发送问题。如果你的场景涉及更复杂的需求（如批量发送、HTML邮件），可以进一步扩展代码逻辑。

到此这篇关于Python利用SMTP发送邮件的常见问题与解决方案详解的文章就介绍到这了,更多相关Python SMTP发送邮件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！