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

引言

在自动化办公和系统开发中，邮件发送功能是常见的需求。无论是发送通知、报告，还是传输文件，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