CodeBlog

A person blog

0%

通过Python调用邮件服务的实战

发表于 分类于

通过Python调用邮件服务的实战

在现代软件开发中，自动发送邮件是一项常见的需求。无论是系统监控告警、用户注册验证、还是定时报告发送，Python都提供了强大的库来实现邮件服务的调用。本文将详细介绍如何使用Python调用邮件服务，包括依赖库、调用方法、代码示例以及可能出现的错误和解决方案。

一、依赖的库

Python标准库中已经包含了用于发送邮件的模块，主要有以下几个：

1. smtplib

smtplib是Python标准库中用于发送邮件的核心模块，它实现了SMTP（Simple Mail Transfer Protocol）客户端协议，可以连接到SMTP服务器并发送邮件。

2. email

email模块用于构建和解析邮件消息，包括邮件头、邮件正文、附件等。它提供了一系列类来创建结构化的邮件内容。

3. ssl

ssl模块用于创建安全的SSL/TLS连接，在发送加密邮件时使用。

二、调用方法

1. 基本邮件发送

以下是使用Python发送基本文本邮件的步骤：

步骤1：导入所需模块

1
2
3
import smtplib
from email.mime.text import MIMEText
from email.header import Header

步骤2：配置邮件服务器信息

1
2
3
4
5
# 邮件服务器配置
smtp_server = 'smtp.qq.com'  # QQ邮箱SMTP服务器
smtp_port = 465  # SSL端口
username = 'your_email@qq.com'  # 发件人邮箱
password = 'your_password'  # 邮箱密码或授权码

步骤3：创建邮件内容

1
2
3
4
5
6
7
8
9
# 邮件内容
subject = 'Python邮件测试'
body = '这是一封通过Python发送的测试邮件！'

# 创建MIMEText对象
msg = MIMEText(body, 'plain', 'utf-8')
msg['From'] = Header('发件人名称', 'utf-8')
msg['To'] = Header('收件人名称', 'utf-8')
msg['Subject'] = Header(subject, 'utf-8')

步骤4：发送邮件

1
2
3
4
5
6
7
8
9
10
11
12
13
try:
    # 创建SSL连接
    server = smtplib.SMTP_SSL(smtp_server, smtp_port)
    # 登录邮件服务器
    server.login(username, password)
    # 发送邮件
    server.sendmail(username, ['recipient@example.com'], msg.as_string())
    print('邮件发送成功！')
except Exception as e:
    print(f'邮件发送失败：{e}')
finally:
    # 关闭连接
    server.quit()

2. 发送HTML格式邮件

如果需要发送HTML格式的邮件，可以将MIMEText的subtype参数设置为’html’：

1
2
3
4
5
6
7
8
9
10
11
12
13
# HTML邮件内容
html_body = """
<html>
  <body>
    <h1>Python HTML邮件测试</h1>
    <p>这是一封<strong>HTML格式</strong>的测试邮件！</p>
    <a href="https://www.python.org">访问Python官网</a>
  </body>
</html>
"""

# 创建HTML邮件
msg = MIMEText(html_body, 'html', 'utf-8')

3. 发送带附件的邮件

发送带附件的邮件需要使用email.mime.multipart.MIMEMultipart类：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.application import MIMEApplication
from email.header import Header

# 创建MIMEMultipart对象
msg = MIMEMultipart()
msg['From'] = Header('发件人名称', 'utf-8')
msg['To'] = Header('收件人名称', 'utf-8')
msg['Subject'] = Header('带附件的Python邮件测试', 'utf-8')

# 添加正文
body = '这是一封带附件的测试邮件！'
msg.attach(MIMEText(body, 'plain', 'utf-8'))

# 添加附件
file_path = 'example.txt'
with open(file_path, 'rb') as f:
    attachment = MIMEApplication(f.read(), _subtype='txt')
    attachment.add_header('Content-Disposition', 'attachment', filename=('utf-8', '', '示例文件.txt'))
    msg.attach(attachment)

# 发送邮件（代码同上）

三、常见错误及解决方案

1. 认证失败错误

错误信息：smtplib.SMTPAuthenticationError: (535, b'Login Fail. Please enter your authorization code to login.')

解决方案：

  • 确保用户名和密码正确
  • 对于QQ、163等邮箱，需要使用授权码而非登录密码
  • 检查邮箱是否开启了SMTP服务

2. 连接错误

错误信息：smtplib.SMTPServerDisconnected: Connection unexpectedly closed

解决方案：

  • 检查SMTP服务器地址和端口是否正确
  • 确保网络连接正常
  • 尝试使用不同的端口（如465、587）

3. SSL错误

错误信息：ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed

解决方案：

  • 确保SSL证书有效
  • 可以临时禁用证书验证（不推荐用于生产环境）：
    1
    2
    3
    4
    5
    import ssl
    context = ssl.create_default_context()
    context.check_hostname = False
    context.verify_mode = ssl.CERT_NONE
    server = smtplib.SMTP_SSL(smtp_server, smtp_port, context=context)

4. 邮件被标记为垃圾邮件

解决方案：

  • 确保邮件内容规范，避免使用垃圾邮件关键词
  • 添加正确的发件人信息和回复地址
  • 配置SPF、DKIM等邮件验证机制
  • 避免频繁发送大量邮件

5. 字符编码错误

错误信息：UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-3: ordinal not in range(128)

解决方案：

  • 确保所有字符串都使用正确的编码（如UTF-8）
  • 使用email.header.Header类处理中文标题和发件人信息

四、进阶用法

1. 使用第三方库

除了标准库外，还有一些第三方库可以简化邮件发送，如yagmail：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
import yagmail

# 配置邮件服务器
yag = yagmail.SMTP(user='your_email@qq.com', password='your_password', host='smtp.qq.com')

# 发送邮件
yag.send(
    to='recipient@example.com',
    subject='yagmail测试',
    contents='这是使用yagmail发送的测试邮件！',
    attachments='example.txt'
)

# 关闭连接
yag.close()

2. 发送带图片的HTML邮件

在HTML邮件中嵌入图片需要使用email.mime.image.MIMEImage类：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
from email.mime.image import MIMEImage

# 添加图片到邮件
with open('image.jpg', 'rb') as f:
    img = MIMEImage(f.read())
    img.add_header('Content-ID', '<image1>')
    msg.attach(img)

# 在HTML中引用图片
html_body = f"""
<html>
  <body>
    <h1>带图片的HTML邮件</h1>
    <p>这是一张图片：</p>
    <img src="cid:image1" alt="测试图片">
  </body>
</html>
"""

3. 批量发送邮件

对于需要批量发送邮件的场景，可以使用循环遍历收件人列表：

1
2
3
4
5
6
7
8
9
10
# 收件人列表
recipients = ['user1@example.com', 'user2@example.com', 'user3@example.com']

# 批量发送
for recipient in recipients:
    try:
        server.sendmail(username, [recipient], msg.as_string())
        print(f'向 {recipient} 发送邮件成功！')
    except Exception as e:
        print(f'向 {recipient} 发送邮件失败：{e}')

五、总结

通过Python调用邮件服务是一项实用的技能，可以帮助我们实现各种自动化邮件发送需求。本文介绍了使用Python标准库smtplib和email发送邮件的方法，包括基本文本邮件、HTML邮件和带附件的邮件，并详细说明了常见错误及解决方案。

在实际应用中，需要根据具体需求选择合适的发送方式，并注意邮件服务器的配置和安全设置。同时，为了提高邮件的送达率，还需要注意邮件内容的规范和反垃圾邮件策略。

希望本文能够帮助你掌握Python调用邮件服务的技能，为你的项目开发提供便利！

六、参考资料

  1. Python官方文档 - smtplib
  2. Python官方文档 - email
  3. QQ邮箱SMTP服务设置
  4. 163邮箱SMTP服务设置

欢迎关注我的其它发布渠道