阿里邮箱IMAP场景示例：获取邮件信息（SELECT、SEARCH和FETCH）

基本流程

关键动作

• SELECT

功能：用于选择一个邮箱，使其成为当前操作的目标。

• SEARCH

功能：用于搜索满足特定条件的邮件。

• FETCH

功能：用于获取指定邮件的详细信息。

重要

风险提示：下述代码在Python 3.11.9进行的测试，用于生产环境之前请务必先做好测试。

Python示例代码

场景：登录邮箱，选择收件箱，搜索未读邮件，获取邮件eml原文内容。

# -*- coding: utf-8 -*-import imaplibfrom imapclient import imap_utf7

imap_server = 'imap.qiye.aliyun.com'username = 'test@example.com'password = '********'imap_port = 993# 连接到IMAP服务器mail = imaplib.IMAP4_SSL(imap_server, imap_port)
mail.login(username, password)# 选择邮箱（例如 "INBOX"）folder_name = imap_utf7.encode('INBOX')  # utf-7编码，中文编码mail.select(folder_name)# 搜索未读邮件status, data = mail.search(None, 'UNSEEN')if status == 'OK':
    mail_ids = data[0].split()    for mail_id in mail_ids:        # 获取邮件的完整内容
        status, msg_data = mail.fetch(mail_id, '(RFC822)')        if status == 'OK':            print(f"邮件ID：{mail_id.decode()}")            print("邮件内容：")            print(msg_data[0][1].decode())# 关闭连接mail.logout()

参数示例

SELECT注意事项

中文文件夹要utf-7编码

import imaplibfrom imapclient import imap_utf7

imap_server = 'imap.qiye.aliyun.com'username = 'test@example.com'password = '******'port = 993mail = imaplib.IMAP4_SSL(imap_server, port)# 登录mail.login(username, password)# 选择邮箱（例如 "收件箱"）folder_name = imap_utf7.encode('收件箱')  # utf-7编码，中文编码mail.select(folder_name)print('已选择邮箱')

常见问题

文件夹编码错误，可以使用list命令查看文件夹名称，使用imap_utf7进行中文编码。

imaplib.IMAP4.error: SELECT command error: BAD [b'invalid command or parameters']
UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-2: ordinal not in range(128)

SEARCH支持的参数

import imaplibfrom imapclient import imap_utf7

imap_server = 'imap.qiye.aliyun.com'username = 'test@example.com'password = '******'port = 993mail = imaplib.IMAP4_SSL(imap_server, port)# 登录mail.login(username, password)# 选择邮箱（例如 "INBOX"）folder_name = imap_utf7.encode('INBOX')  # utf-7编码，中文编码mail.select(folder_name)# search 示例status, data = mail.search(None, 'SEEN')  # 已读# status, data = mail.search(None, 'UNSEEN')  # 未读# status, data = mail.search(None, 'ALL')  # 全部# status, data = mail.search(None, '(SEEN)')  # 另一种写法# status, data = mail.search(None, '(SEEN UNSEEN)')  # 支持多条件# status, data = mail.search(None, 'SEEN', ' UNSEEN')  # 支持多条件,逗号间隔# status, data = mail.search(None, '1')  # UID# status, data = mail.search(None, '(1 2)')  # UIDs #支持多UID# status, data = mail.search(None, 'ON 10-Jan-2024')  # 搜索某一天的邮件# status, data = mail.search(None, 'SINCE 10-Jan-2024')  # 搜索大于等于某天的邮件# status, data = mail.search(None, "(SINCE 05-Dec-2023 BEFORE 12-Jan-2024)")  # SINCE代表开始，BEFORE代表结束## status, data = mail.search(None, 'BEFORE', '12-Jan-2024', 'SEEN')  # 搜索某个日期前的邮件，不包含该日期# status, data = mail.search(None, 'BEFORE', '12-Jan-2024', 'SEEN', 'ON 05-Dec-2023')  # 支持多条件，ON 是搜索某一天的邮件# status, data = mail.search(None, 'BEFORE 12-Jan-2024', 'SEEN', 'ON 05-Dec-2023')  # 另一种写法# status, data = mail.search(None, 'BEFORE 12-Jan-2023 SEEN ON 05-Dec-2022')# status, data = mail.search(None, "SENTSINCE 26-Mar-2024")  # 自某个日期以来发送的邮件print(status, data)  # 返回uid信息

运行结果

SEARCH不支持的参数示例

# mail.search(None, '(SUBJECT "主题")')# mail.search(None, 'SUBJECT "测试"'.encode('utf-8'))# mail.search(None, 'OR FROM "a***@example.net"', 'SUBJECT "测试"'.encode('utf-8'))# mail.search(None, '(FROM "昵称")')# mail.search(None, 'FROM', '"昵称"')# mail.search('GB2312', 'FROM "**example**.com"')# mail.search(None, '(FROM "Doug" SUBJECT "Example message 2")')# mail.search(None, "FROM", '"昵称"')# mail.search([u'SINCE', date(2024, 1, 20)])

FETCH支持的参数

import imaplibfrom imapclient import imap_utf7

imap_server = 'imap.qiye.aliyun.com'username = 'test@example.com'password = '******'port = 993# 连接到IMAP服务器mail = imaplib.IMAP4_SSL(imap_server, port)
mail.login(username, password)# 选择邮箱（例如 "INBOX"）folder_name = imap_utf7.encode('INBOX')  # utf-7编码，中文编码mail.select(folder_name)# 搜索未读邮件status, data = mail.search(None, 'UNSEEN')if status == 'OK':
    mail_ids = data[0].split()    for mail_id in mail_ids:        # 获取邮件的完整内容
        f_status, msg_data = mail.fetch(mail_id, '(RFC822)')        # f_status, msg_data = mail.fetch(num, 'UID')  # v_type1= OK data1= [b'1 (UID 12)']
        # f_status, msg_data = mail.fetch(num, 'BODY[]')  # (RFC822)等效
        # f_status, msg_data = mail.fetch(num, '(UID BODY[HEADER])')  # 返回完整的文件头信息。
        # f_status, msg_data = mail.fetch(num, '(UID BODY[HEADER.FIELDS (Subject)])')  # 在小括号里面可以指定返回的特定字段。如，Subject
        # f_status, msg_data = mail.fetch(num, '(UID BODY[TEXT])')  # 邮件内容，返回的数据是消息部分数据的元组
        # f_status, msg_data = mail.fetch(num, 'FLAGS')[1]  # [b'3 (UID 16 FLAGS (\\Seen))']#获取UID，需要处理返回数据

        if f_status == 'OK':            print(f"邮件ID： {mail_id.decode()}")            print("邮件内容：")            print(msg_data[0][1].decode())# 关闭连接mail.logout()

运行结果

FETCH不支持的参数

# status, data = mail.fetch(num, '(UID BODY[HEADER.FIELDS.NOT (Subject)])')# status, data = mail.fetch('2:3', '(RFC822)')  #范围

常见问题

出现如下报错，通常是对应的阶段如SEARCH或FETCH中的参数错误或不支持，建议参考示例使用支持的命令参数。

imaplib.error: SEARCH command error: BAD [b'invalid command or parameters']
imaplib.error: FETCH command error: BAD [b'invalid command or parameters']